_________________________________________________________________
NAME
Tk_CreateTimerHandler, Tk_DeleteTimerHandler - call a procedure at a given time
SYNOPSIS
#include <tk.h>
Tk_TimerToken
Tk_CreateTimerHandler(milliseconds, proc, clientData)
Tk_DeleteTimerHandler(token)
Tk_TimerToken token (in) Token for previously-created
Proc should have arguments and return value that match the type Tk_TimerProc:
typedef void Tk_TimerProc(ClientData clientData); The clientData parameter to proc is a copy of the clientData argument given to Tcl_CreateTimerHandler when the callback was created. Typically, clientData points to a data structure containing application-specific information about what to do in proc.
Tk_DeleteTimerHandler may be called to delete a previously-created timer handler. It deletes the handler indicated by token so that no call to proc will be made; if that handler no longer exists (e.g. because the time period has already elapsed and proc has been invoked) then Tk_DeleteTimerHandler does nothing.
KEYWORDS
callback, clock, handler, timer