Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

XCheckTypedEvent − return the next event in queue that matches event type; don’t wait.

Synopsis

Bool XCheckTypedEvent(display, event_type, event_return)
Display *display;
int event_type;
XEvent *event_return;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

event_type
Specifies the event type to be compared.

event_return
Returns a copy of the matched event structure.

Description

XCheckTypedEvent() searches first the event queue, then the events available on the server connection, for the specified event_type.  If there is a match, it returns the associated event structure.  Events searched but not matched are not discarded.  XCheckTypedEvent() returns True if the event is found.  If the event is not found, XCheckTypedEvent() flushes the request buffer and returns False.  This command is similar to XCheckMaskEvent(), but it searches through the queue and any events available on the server connection instead of inspecting only the last item on the queue.  It also matches only a single event type instead of multiple event types as specified by a mask.  For more information, see Volume One, Chapter 8, Events. 

See Also

QLength(), XAllowEvents(), XCheckIfEvent(), XCheckMaskEvent(), XCheckTypedWindowEvent(), XCheckWindowEvent(), XEventsQueued(), XGetInputFocus(), XGetMotionEvents(), XIfEvent(), XMaskEvent(), XNextEvent(), XPeekEvent(), XPeekIfEvent(), XPending(), XPutBackEvent(), XSelectInput(), XSendEvent(), XSetInputFocus(), XSynchronize(), XWindowEvent. 

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026