XCheckIfEvent

Syntax

Bool XCheckIfEvent(display, event_return, predicate, arg)
      Display *display;
      XEvent *event_return;
      Bool (*predicate)();
      XPointer arg;

Arguments

display Specifies the connection to the X server.
event_return Returns a copy of the matched event's associated structure.
predicate Specifies the procedure that is to be called to determine if the next event in the queue matches what you want.
arg Specifies the user-supplied argument that will be passed to the predicate procedure.

Description

When the predicate procedure finds a match, XCheckIfEvent() copies the matched event into the client-supplied XEvent structure and returns True. (This event is removed from the queue.) If the predicate procedure finds no match, XCheckIfEvent() returns False, and the output buffer will have been flushed. All earlier events stored in the queue are not discarded.

See also

XIfEvent(), XNextEvent(), XPeekIfEvent(), XPutBackEvent(), XSendEvent(), "Selecting Events Using a Predicate Procedure".
Christophe Tronche, ch@tronche.com