XtAppAddTimeOut — invoke a procedure after a specified timeout. 

Synopsis

XtIntervalId XtAppAddTimeOut(app_context, interval, proc, client_data)

    XtAppContext app_context;
    unsigned long interval;
    XtTimerCallbackProc proc;
    XtPointer client_data;

Arguments

app_context
Specifies the application context for which the timer is to be set.

intervalSpecifies the time interval in milliseconds. 

procSpecifies the procedure that is to be called when the time expires.  See XtTimerCallbackProc(2). 

client_data
Specifies the argument to be passed to the specified procedure when it is called.

Description

XtAppAddTimeOut allows a program to have a function called after a specified timeout.  XtAppAddTimeOut creates the timeout and returns an identifier for it.  The length of the timeout value is interval milliseconds. 

The Intrinsics invoke the specified callback when interval elapses, and the timeout is removed from the event queue. 

The return value XtIntervalID uniquely identifies the pending timer pseudo-event.  The pending event can be deleted from the queue before the interval expires by calling XtRemoveTimeOut. 

The callback procedure pointer that is invoked when timeouts expire is of type XtTimerCallbackProc. 

XtAppNextEvent and XtAppPeekEvent dispatch timer queue entries. 

See Also

XtAppNextEvent(1), XtAppPeekEvent(1), XtDispatchEvent(1), XtRemoveTimeOut(1),
XtTimerCallbackProc(2).