XtAppPending()XtAppPending()NameXtAppPending - determine whether any events are in an application's
input queue.
Synopsis
XtInputMask XtAppPending(app_context)
XtAppContext app_context;
Inputs
app_context
Specifies the application context.
Returns
An XtInputMask which indicates what kind of events, if any, are pending
on app_context.
DescriptionXtAppPending() returns a nonzero value if there are pending events from
the X server, timer, or other input sources.
The return value is a bit mask that is the OR of XtIMXEvent (an X
event), XtIMTimer (a timer event-see XtAppAddTimeOut()), and XtIMAlter‐
nateInput (an alternate input event-see XtAppAddInput()). As a conve‐
nience, the symbolic name XtIMAll is defined as the bitwise inclusive
OR of all event types. If no events are pending, XtAppPending()
flushes the output buffers of each display in the application context
and returns zero. This call is the Intrinsics equivalent to the Xlib
call XPending().
XtAppPending() never blocks.
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), XtAppMainLoop(1), XtAppNex‐
tEvent(1), XtAppPeekEvent(1), XtAppProcessEvent(1), XtDispatchEvent(1).
Xt - Event Handling XtAppPending()