XtRemoveTim(3x) — HPUX 9.05

NAME

XtRemoveTimeOut − unregister a timeout procedure.

Synopsis

void XtRemoveTimeOut(id)

XtIntervalId id;

Inputs

idIdentifies the timeout interval and the timeout callback to be removed.

Description

XtRemoveTimeOut() unregisters the timeout callback identified by id. id is the handle returned by the call to XtAppAddTimeOut() that registered the timeout interval and the procedure.

Usage

Note that timeouts are automatically removed once they expire and the callback has been called; therefore, you often do not need to call XtRemoveTimeOut(). On the other hand, if you need user input within a specified amount of time, for example, then you should register a timeout callback, and if the input arrives before the timeout callback is called, then you should remove the timeout callback so that it isn’t called when the application is not expecting it.

Structures

The XtIntervalId structure is defined as follows:

typedef unsigned long XtIntervalId;

Museum