XWindowEvent() XWindowEvent()
Name
XWindowEvent - remove the next event that matches the specified mask and window.
Synopsis
XWindowEvent(display, w, event_mask, event_return)
Display *display;
Window w;
long event_mask;
XEvent *event_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window whose next matching event you want.
event_mask
Specifies the event mask. See XSelectInput() for a complete list of event masks.
event_return
Returns the event removed from the input queue.
Description
XWindowEvent() removes the next event in the queue which matches both the passed window and the passed mask. The event is copied into an
XEvent structure supplied by the caller. Other events in the queue are not discarded. If no such event has been queued, XWindowEvent()
flushes the request buffer and waits until one is received.
XWindowEvent() cannot return ClientMessage, MappingNotify, SelectionClear, SelectionNotify, or SelectionRequest events because these event
types are by definition unmaskable.
Structures
See individual event structures described in Volume One, Chapter 8, Events, and Appendix F, Structure Reference, in this volume.
See Also
XQLength(), XAllowEvents(), XCheckIfEvent(), XCheckMaskEvent(), XCheckTypedEvent(), XCheckTypedWindowEvent(), XCheckWindowEvent(),
XEventsQueued(), XGetInputFocus(), XGetMotionEvents(), XIfEvent(), XMaskEvent(), XNextEvent(), XPeekEvent(), XPeekIfEvent(), XPending(),
XPutBackEvent(), XSelectInput(), XSendEvent(), XSetInputFocus(), XSynchronize().
Xlib - Input Handling XWindowEvent()
