XtProcessEv(3x) — HP-UX 9.05

NAME

XtProcessEvent − get and process one input event of a specified type.

Synopsis

void XtProcessEvent(mask)

XtInputMask mask;

Inputs

maskSpecifies what types of events to process.

Availability

XtProcessEvent() has been superseded by XtAppProcessEvent().

Description

XtProcessEvent() processes one X event, alternate input source event or timer event. 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. XtProcessEvent() calls any registered background work procedures if there are no events available, and blocks if there are no events and no work procedures.

Usage

XtProcessEvent() has been superseded by XtAppProcessEvent(), which performs the same function on a per-application context basis. XtProcessEvent() now calls
XtAppProcessEvent() passing the default application context created by
XtInitialize(). Very few programs need multiple application contexts, and you can
continue to use XtProcessEvent() if you initialize your application with
XtInitialize(). We recommend, however, that you use XtAppInitialize(), XtAppProcessEvent(), and the other XtApp*() application context specific functions. See XtAppProcessEvent() for more information. Programs rarely need this much control over the event dispatching mechanism. Most programs use XtAppMainLoop().

Museum