hpux man page for xwindowevent

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()