XtAddTimeOut() XtAddTimeOut()
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
interval Specifies the time interval in milliseconds.
proc Specifies 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 pro-
cedure 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. XtAddTime-
Out() 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).
Xt - Event Handling XtAddTimeOut()
