Timer

The timer button is an invisible button that can be used to create repeated events in a window. This is often used for animations or repetitive scripts within a window. When running, the timer's Value property is incremented by the Step By value, until the value tis the Bound, at which point it repeats. It is often useful to bind other values to a timer's Value property.

For instance, if you set the timer's Bound property to 360, and bind an object's rotation to the Value property, the object will spin in a circle when the timer is running.

Or, suppose that you have images that make up frames of animation. Name your images: "Frame0.png", "Frame1.png", "Frame2.png". Set the timer's Bound to be 3, Then bind the image path of an image component to the following expression:

How fast the timer counts is up to the Delay property, which is the time between counts in milliseconds.

Want to run a script every time the timer counts? First, make sure you don't actually want to write a project Timer Script, which will run on some interval whenever the application is running. In contrast, a script that works via a Timer component will only run while the window that contains the Timer is open, and the Timer is running. The way to do this is to attach an event script to the actionPerformed event.

Behavior

Delay (ms)

The delay in milliseconds between timer events.

Scripting name	delay
Data type	int
Flags	bindable

Initial Delay (ms)

The delay in milliseconds before the first event when running is set to true.

Scripting name	initialDelay
Data type	int
Flags	bindable

Running?

Determines whether or not the timer sends timer events.

Scripting name	running
Data type	boolean
Flags	bindable

Common

Name

The name of this component.

Scripting name	name
Data type	String

Data

Value

The current value of this timer, for use as a counter.At each iteration, this value will be set to ((value + step) MOD bound)

Scripting name	value
Data type	int
Flags	bindable

Step by

The amount added to the value each time this timer fires for use as a counter. (should be positive)

Scripting name	step
Data type	int

Bound

The value is always guaranteed to be less than this upper bound.

Scripting name	max
Data type	int

The following event sets are fired by this component. See Component Event Handlers to learn more.