XWindowEvent

Syntax

XWindowEvent(display, w, event_mask, event_return)
      Display *display;
      Window w;
      long event_mask;
      XEvent *event_return;

Arguments

display Specifies the connection to the X server.
w Specifies the window whose events you are interested in.
event_mask Specifies the event mask.
event_return Returns the matched event's associated structure.

Description

The XWindowEvent() function searches the event queue for an event that matches both the specified window and event mask. When it finds a match, XWindowEvent() removes that event from the queue and copies it into the specified XEvent structure. The other events stored in the queue are not discarded. If a matching event is not in the queue, XWindowEvent() flushes the output buffer and blocks until one is received.

See also

XCheckMaskEvent(), XCheckTypedEvent(), XCheckTypedWindowEvent(), XCheckWindowEvent(), XIfEvent(), XMaskEvent(), XNextEvent(), XPeekEvent(), XPutBackEvent(), XSendEvent(), "Selecting Events Using a Window or Event Mask".
Christophe Tronche, ch@tronche.com