Difference between revisions of "Lua:Class:Timer"
Jump to navigation
Jump to search
| Line 1: | Line 1: | ||
| − | ''' | + | Timer '''class''': ('''Inheritance''': ''[[Component]]''->''[[Object]]'') |
| − | |||
| + | The timer class is an non visual component that when active triggers an onTimer event every tick. (base on Interval property) | ||
| − | ''' | + | == Creation == |
| − | + | ; [[createTimer]](''owner'' OPTIONAL, ''enabled'' OPTIONAL) | |
| − | + | : Returns a newly created timer object. | |
| + | : If enabled is not given it will be enabled by default (will start as soon as an onTimer event has been assigned) | ||
| + | : Owner may be nil, but you will be responsible for destroying it instead of being the responsibility of the owner object) | ||
| + | Tip: use [[getMainForm]] for the owner of any timer so that it is destroyed when the main form is destroyed (closed). | ||
| + | createTimer(getMainForm()) | ||
| − | + | == Properties == | |
| − | + | ; Interval : integer | |
| + | : The number of milliseconds (1000 = 1 second) between ticks (executions). | ||
| + | ; Enabled : boolean | ||
| + | : The enable state of the Timer. | ||
| − | + | ; OnTimer : function(timer) | |
| − | + | : The function to call when the timer triggers (tick). | |
| + | == Methods == | ||
| − | + | ; getInterval() : integer | |
| − | + | : Returns the speed on how often the timer will trigger. In milliseconds (1000 = 1 second). | |
| + | ; setInterval(''interval'') | ||
| + | : Sets the speed on how often the timer should trigger. In milliseconds (1000 = 1 second). | ||
| − | ''' | + | ; getOnTimer() : function(''timer'') |
| + | : Returns the 'OnTimer' event. | ||
| − | + | ; setOnTimer(''function(timer)'') | |
| + | : Sets the 'OnTimer' event. | ||
| − | + | ; getEnabled() : boolean | |
| + | : Returns the enable state of the Timer. | ||
| − | + | ; setEnabled(''state'') | |
| − | + | : Sets the enable state of the Timer. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | == See also == | ||
| + | * [[Lua]] | ||
| + | * [[Help_File:Script engine|Script engine]] | ||
| − | + | === Related Functions === | |
| + | * [[createTimer]] | ||
| − | * [[ | + | === Related Classes === |
| + | * [[Component]] | ||
Revision as of 04:58, 11 March 2017
Timer class: (Inheritance: Component->Object)
The timer class is an non visual component that when active triggers an onTimer event every tick. (base on Interval property)
Creation
- createTimer(owner OPTIONAL, enabled OPTIONAL)
- Returns a newly created timer object.
- If enabled is not given it will be enabled by default (will start as soon as an onTimer event has been assigned)
- Owner may be nil, but you will be responsible for destroying it instead of being the responsibility of the owner object)
Tip: use getMainForm for the owner of any timer so that it is destroyed when the main form is destroyed (closed).
createTimer(getMainForm())
Properties
- Interval : integer
- The number of milliseconds (1000 = 1 second) between ticks (executions).
- Enabled : boolean
- The enable state of the Timer.
- OnTimer : function(timer)
- The function to call when the timer triggers (tick).
Methods
- getInterval() : integer
- Returns the speed on how often the timer will trigger. In milliseconds (1000 = 1 second).
- setInterval(interval)
- Sets the speed on how often the timer should trigger. In milliseconds (1000 = 1 second).
- getOnTimer() : function(timer)
- Returns the 'OnTimer' event.
- setOnTimer(function(timer))
- Sets the 'OnTimer' event.
- getEnabled() : boolean
- Returns the enable state of the Timer.
- setEnabled(state)
- Sets the enable state of the Timer.