Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XtAppNextEvent(1)

NAME

XtNextEvent − return next event from input queue. 

Synopsis

void XtNextEvent(event_return)

    XEvent *event_return;

Inputs

None. 

Outputs

event_return
Returns the dequeued event structure.

Availability

XtNextEvent() has been superseded by XtAppNextEvent(). 

Description

XtNextEvent() returns the next event on the input queue.  If no events are pending, it flushes the output buffer and blocks.  It also dispatches timer and alternate input callbacks and calls any work procedures that have been registered with XtAddWorkProc(). 

Usage

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

See Also

XtAppNextEvent(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026