xtpeekevent(3) [hpux man page]

XtPeekEvent()															     XtPeekEvent()

Name
  XtPeekEvent - return, but do not remove the event at	the head of an application's input queue.

Synopsis
  Boolean XtPeekEvent(event_return)
	 XEvent *event_return;

Inputs
  event_return
	      Returns the event information from the head event structure in the queue.

Returns
  True if the event at the head of the queue is an X event; False if it is a timer event or an alternate input source event.

Availability
  XtPeekEvent() has been superseded by XtAppPeekEvent().

Description
  XtPeekEvent() returns a copy of the X event at the head of the input queue, without removing it from the queue.  If there is an X event, it
  returns True.  If there are no X events pending, but there are timer or alternate events, XtPeekEvent() returns False.   If  there  are  no
  events pending, XtPeekEvent() blocks.

Usage
  XtPeekEvent()  has been superseded by XtAppPeekEvent(), which performs the same function on a per-application context basis.	XtPeekEvent()
  now calls XtAppPeekEvent() passing the default application context created by XtInitialize().  Very few programs need multiple  application
  contexts,  and  you  can continue to use XtPeekEvent() if you initialize your application with XtInitialize().  We recommend, however, that
  you use XtAppInitialize(), XtAppPeekEvent(), and the other XtApp*() application context specific functions.

  See XtAppPeekEvent() for more information.

  Programs rarely need this much control over the event dispatching mechanism.	Most programs use XtAppMainLoop().

See Also
  XtAppMainLoop(1), XtAppPeekEvent(1), XtAppPending(1).

Xt - Event Handling														     XtPeekEvent()

Check Out this Related Man Page

XtNextEvent(3)						    XT COMPATIBILITY FUNCTIONS						    XtNextEvent(3)

NAME

       XtNextEvent, XtPending, XtPeekEvent, XtProcessEvent, XtMainLoop - query and process events and input

SYNTAX

       void XtNextEvent(XEvent *event_return);

       Boolean XtPeekEvent(XEvent *event_return);

       Boolean XtPending(void);

       void XtProcessEvent(XtInputMask mask);

       void XtMainLoop(void);

ARGUMENTS

       event	 Specifies a pointer to the event structure that is to be dispatched to the appropriate event handler.

       event_return
		 Returns the event information to the specified event structure.

       mask	 Specifies what types of events to process.  The mask is the bitwise inclusive OR of any combination of XtIMXEvent, XtIMTimer,
		 XtIMAlternateInput, and XtIMSignal.  As a convenience, the X Toolkit defines the symbolic name XtIMAll to be the bitwise inclu-
		 sive OR of all event types.

DESCRIPTION

       XtNextEvent has been replaced by XtAppNextEvent.

       XtPeekEvent has been replaced by XtAppPeekEvent.

       XtPending has been replaced by XtAppPending.

       XtProcessEvent has been replaced by XtAppProcessEvent.

       XtMainLoop has been replaced by XtAppMainLoop.

SEE ALSO

       XtAppNextEvent(3xt), XtAppPending(3), XtAppPeekEvent(3), XtAppProcessEvent(3), XtAppMainLoop(3)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    libXt 1.1.3 						    XtNextEvent(3)

Linux and UNIX Man Pages

xtpeekevent(3) [hpux man page]

Check Out this Related Man Page