Timer UI Control

A timer control generates tick events at set intervals. Timer is unlike the remainder of the user-interface items as it is not a visible control. Timer lets the user interface react, animate, or change without user interaction, such as having animations playing on the rollout, checking for certain conditions or events before continuing, displaying nag/splash screens, and so on.

The syntax is:

timer <name> [interval:<number>] [active:<boolean>]      

EXAMPLE:

   rollout test "Test Timer"
   (
     timer clock "testClock" interval:1000 --tick once a second
     label test"1"
     on clock tick do
     (
       valUp = (test.text as integer)+1
       test.text = valUp as string
     )
   )
   createDialog test

Parameters:

interval:   

An integer value specifying the time in milliseconds between tick events. Default value 1000 (1 second).

active: 

Specifies whether the timer emits tick events. Default value true .

Properties:

<timer>.interval Integer 

Integer value specifying the time in milliseconds between tick events.

<timer>.active Boolean 

Specifies whether the timer emits tick events ( true ) or not ( false ). When first set to true , the first tick event is generated in interval milliseconds.

<timer>.ticks Integer 

The read/write .ticks property is incremented by 1 on each ‘tick’ of the timer. Can be both get and set.

Events:

on <timer> tick do <expr> 

Called when timer ticks.