NAME

XtAddTimeOut − register a procedure to be called when a specified time elapses. 

Synopsis

XtIntervalId XtAddTimeOut(interval, proc, client_data)

    unsigned long interval;
    XtTimerCallbackProc proc;
    XtPointer client_data;

Inputs

intervalSpecifies the time interval in milliseconds. 

procSpecifies the procedure to be called when the time expires. 

client_data
Specifies data to be passed to proc when it is called. 

Returns

A handle of type XtIntervalId that can be used to unregister the timeout procedure with XtRemoveTimeOut(). 

Availability

Superseded by XtAppAddTimeOut(). 

Description

XtAddTimeOut() registers a procedure proc, to be called by XtAppNextEvent() with client_data after interval milliseconds elapse.  The procedure is called once and automatically unregistered; it will not be called repeatedly every interval milliseconds. 

Usage

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

See Also

XtAppAddTimeOut(1), XtAppNextEvent(1), XtRemoveTimeOut(1),
XtTimerCallbackProc(2). 

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