xtaddtimeout(3) [hpux man page]
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()
Check Out this Related Man Page
XtAppAddTimeOut() XtAppAddTimeOut() XtAppAddTimeOut - register a procedure to be called when a specified time elapses. Synopsis XtIntervalId XtAppAddTimeOut(app_context, interval, proc, client_data) XtAppContext app_context; unsigned long interval; XtTimerCallbackProc proc; XtPointer client_data; Inputs app_context Specifies the application context in which the timer is to be set. interval Specifies the time interval in milliseconds. proc Specifies the procedure that is to be called when the time expires. See XtTimerCallbackProc(2). 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(). Description XtAppAddTimeOut() registers, in application context app_context, 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. See XtTimerCallbackProc(2) for an explanation of how to write a timer callback. Usage Timer callbacks are automatically unregistered after they are triggered. To have a callback called at a regular interval, call XtAppAd- dTimeOut() again from within the timer callback. A timer callback can be explicitly unregistered before it is invoked by calling XtRemoveTimeOut() with the XtIntervalId returned by this function. Structures The XtIntervalId type is defined as follows: typedef unsigned long XtIntervalId; See Also XtAppNextEvent(1), XtRemoveTimeOut(1), XtTimerCallbackProc(2). Xt - Event Handling XtAppAddTimeOut()