hpux man page for xtapppending

XtAppPending()															    XtAppPending()

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 XtIMAlter-
  nateInput (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 long    XtInputMask;

     #define XtIMXEvent 	     1
     #define XtIMTimer		     2
     #define XtIMAlternateInput      4
     #define XtIMAll (XtIMXEvent   XtIMTimer   XtIMAlternateInput)

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

Xt - Event Handling														    XtAppPending()