Function: GgiHandleEvents Purpose: Explicitly process outstanding events Category: USER-INTERFACE, SYSTEM File: ggi.src Author: J.P. Terlouw Use: #include "ggi.h" int result; result = GgiHandleEvents(); result - non-zero if one or more events were processed, otherwise zero. Description: GgiHandleEvents() processes all events queued at the time of the call. It returns as soon as the event queue is empty. This function can be useful for checking user actions during a lengthy computation, e.g. to modify its parameters or abort it. Note that the use of this routine can introduce recursion. E.g. if it is called from a keyword handler and any of the processed events changes the keyword associated with this handler, the latter is called recursively. Updates: Sep 11, 1998: JPT, Document created.