XtAppProcessEvent()XtAppProcessEvent()NameXtAppProcessEvent - get and process one input event of a specified
type.
Synopsis
void XtAppProcessEvent(app_context, mask)
XtAppContext app_context;
XtInputMask mask;
Inputs
app_context
Specifies the application context for which to process
events.
mask Specifies what types of events to process.
DescriptionXtAppProcessEvent() processes one X event, alternate input source event
or timer event in app_context. The mask argument specifies which types
of events are to be processed; it is the bitwise inclusive OR ( ) of
any of the values XtIMXEvent, XtIMTimer, or XtIMAlternateInput, or the
value XtIMAll which specifies all three event types.
If there is no event or input of the appropriate type to process, if
there is a background work procedure registered (see XtAppAd‐
dWorkProc()) XtAppProcessEvent() calls that procedure and checks again
for input from all specified sources. If there are no pending events
and no work procedures registered, XtAppProcessEvent() blocks until an
event of one of the specified types occurs.
If X events are specified in mask, and no events are immediately avail‐
able, XtAppProcessEvent() flushes the output buffer of each of the Dis‐
plays in app_context. If there is more than one of the requested types
of input available, it is undefined which will be processed.
XtAppProcessEvent() handles timer and alternate input events by calling
the callback procedures registered for those events (see XtAppAddTime‐
Out() and XtAppAddInput()). It handles X events by passing them to
XtDispatchEvent(). XtDispatchEvent() handles an event by passing it to
the appropriate event handlers (see XtAddEventHandler()) or to the
Translation Manager (which is itself an event handler).
Usage
Programs rarely need this much control over the event dispatching mech‐
anism. Most programs use XtAppMainLoop().
Structures
The XtInputMask type and its possible values are defined as follows:
typedef unsigned long XtInputMask;
#define XtIMXEvent 1
#define XtIMTimer 2
#define XtIMAlternateInput 4
#define XtIMAll (XtIMXEvent XtIMTimer XtIMAlternateInput)
See AlsoXtAppAddInput(1), XtAppAddTimeOut(1), XtAppAddWorkProc(1), XtAppMain‐
Loop(1), XtAppNextEvent(1), XtAppPeekEvent(1), XtAppPending(1), XtDis‐
patchEvent(1).
Xt - Event Handling XtAppProcessEvent()
