AddEventTimer - metoda objektu PmgRoot

Popis:

Zaregistruje požadavek do vnitřního časovače obrazu na jednorázové nebo opakované vyvolání funkce po uplynutí zadané doby.

Syntaxe:

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

Parametry:

nTime	(Long) Časový úsek (interval nebo timeout) v milisekundách, po kterém dojde k vyvolání funkce.
nType	(Long) Typ požadavku na vnitřní časovač. -1 - Funkce bude volána opakovaně se zadanou periodou (interval). 1 - Funkce bude volána jednou se zadaným zpožděním (timeout).
sFuncId	(String) Identifikátor registrované událostní funkce. - umožňuje odebrání funkce metodou RemoveEventTimer - zamezuje duplicitnimu zaregistrování téže funkce - může obsahovat jakékoliv znaky (není to systémový název) - doporučuje se použít např. celou cestu k Pmg objektu
Func	(Function) JavaScript událostní funkce, která bude volána časovačem obrazu.

Poznámka:

Vnitřní časovač obrazu umožňuje vytvářet v obrazu animace (periodické volání), hlídat uplynutí povolené doby nějaké asynchronní události (timeout) nebo reagovat na některé události se zpožděním. A to vše bez vazby na rychlosti obnovování (refresh) obrazu.
Tato metoda je funkční i ve Web obrazech.

Viz také:

- function

- PmgRoot.RemoveEventTimer (metoda)

- PmaRoot.AddEventTimer (metoda)

Příklad:

Příklad opakovaného (10x) spuštění funkce realizovaný dvěma přístupy. První přístup spočívá v opakované nové registraci funkce jednorázového spuštění, dokud je potřeba.

JavaScriptVyber a zkopíruj do schránky


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

Druhý přístup spočívá v jediné registraci funkce pro opakované spuštění, která je odregistrována až je potřeba. A současně provede animaci pohybu grafického objektu "Ellipse" v obrazu.

JavaScriptVyber a zkopíruj do schránky


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