NAME

XtAppPending − 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. 

Description

XtAppPending() 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 XtIMAlternateInput (an alternate input event−see XtAppAddInput()).  As a convenience, 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 mechanism.  Most programs use XtAppMainLoop(). 

Structures

The XtInputMask type and its possible values are defined as follows:

typedef unsigned longXtInputMask;
 #define XtIMXEvent1
#define XtIMTimer2
#define XtIMAlternateInput4
#define XtIMAll (XtIMXEvent | XtIMTimer | XtIMAlternateInput)

See Also

XtAppAddInput(1), XtAppAddTimeOut(1), XtAppMainLoop(1), XtAppNextEvent(1), XtAppPeekEvent(1), XtAppProcessEvent(1), XtDispatchEvent(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates