NAME

XMaskEvent − remove the next event that matches mask. 

Synopsis

XMaskEvent(display, event_mask, event_return)
Display *display;
long event_mask;
XEvent *event_return;

Arguments

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

event_mask
Specifies the event mask. See XSelectInput() for a complete list of the event mask symbols that can be ORed together. 

event_return
Returns the event removed from the input queue.

Description

XMaskEvent() removes the next event in the queue which matches the passed mask.  The event is copied into an XEvent supplied by the caller.  Other events in the queue are not discarded.  If no such event has been queued, XMaskEvent() flushes the request buffer and waits until one is received.  Use XCheckMaskEvent() if you do not wish to wait.  XMaskEvent() cannot return MappingNotify, SelectionClear, SelectionNotify, or SelectionRequest events because these event types are by definition unmaskable. 

See Also

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

Copyright O’Reilly & Assoc.  —