XPeekEvent

SYNTAX

XPeekEvent(display, event_return)
      Display *display;
      XEvent *event_return;

ARGUMENTS

display Specifies the connection to the X server.
event_return Returns a copy of the matched event's associated structure.

Description

The XPeekEvent() function returns the first event from the event queue, but it does not remove the event from the queue. If the queue is empty, XPeekEvent() flushes the output buffer and blocks until an event is received. It then copies the event into the client-supplied XEvent structure without removing it from the event queue.

See also

XCheckMaskEvent(), XCheckTypedEvent(), XCheckTypedWindowEvent(), XCheckWindowEvent(), XIfEvent(), XMaskEvent(), XNextEvent(), XPutBackEvent(), XSendEvent(), XWindowEvent(), "Returning the Next Event"
Christophe Tronche, ch@tronche.com