AddEventTimer - method of the PmaRoot object

Description:

Registers a request into the application timer for unrepeated or repeated calling of a function after a defined time period.

Syntax:

Empty AddEventTimer(Long nTime, Long nType, Function Func)

Calling:

oRoot.AddEventTimer(nTime, nType, Func)

Parameters:

nTime	(Long) Time period (interval or timeout) in milliseconds after which the function is called.
nType	(Long) Inner timer request type. -1 - The function will be called repeatedly with defined period (interval). 1 - The function will be called once with defined delay (timeout).
Func	(Function) JavaScript event function that will be called by application timer.

Example:

The example of repeated (10x) running of a function executed in two ways. The first approach is to repeatedly register new function for single execution while it is needed.

JavaScriptSelect and copy to clipboard


function OnTick()
{
	Pm.Debug("OnTick: tClick=" + Pm.FormatDate(tClicked, 1) + "nCounter = " + nCounter);
	if (nCounter-- > 0)
		pMe.Root.AddEventTimer(1000, 1, OnTick);
}
var tClicked = Pm.Time;
var nCounter = 10;
pMe.Root.AddEventTimer(1000, 1, OnTick);

Another approach is to register the function once for repeated execution and then un-registering it after it is no longer needed. Simultaneously executes animation of graphic object "Ellipse" in the panel.

JavaScriptSelect and copy to clipboard


function OnTick()
{
	Pm.Debug("OnTick: tClick=" + Pm.FormatDate(tClicked, 1) + "nCounter = " + nCounter);
	if (nCounter-- < 0)
		pMe.Root.RemoveEventTimer(OnTick);
}
var tClicked = Pm.Time;
var nCounter = 10;
pMe.Root.AddEventTimer(60, -1, OnTick);