Creates a timer which periodically invokes a callback when the time is up. Each timer should be destroyed using IupDestroy.
Ihandle* IupTimer(void); [in C]
iup.timer{} -> (ih: ihandle) [in Lua]
timer() [in LED]
Returns: the identifier of the created element, or NULL if an error occurs.
TIME: The time interval in milliseconds. In Windows the minimum value is 10ms.
RUN: Starts and stops the timer. Possible values: "YES" or "NO". Returns the current timer state. If you have multiple threads start the timer in the main thread.
WID (read-only): Returns the native serial number of the timer. Returns -1 if not running. A timer is mapped only when it is running.
ACTION_CB: Called every time the defined time interval is reached. To stop the callback from being called simply stop de timer with RUN=NO. Inside the callback the attribute ELAPSEDTIME returns the time elapsed since the timer was started in milliseconds (since 3.15).
int function(Ihandle *ih); [in C] ih:action_cb() -> (ret: number) [in Lua]
ih: identifier of the element that activated the event.
Returns: IUP_CLOSE will be processed.
In GTK uses g_timeout_add, in Windows uses SetTimer, and in Motif uses XtAppAddTimeOut.