Release - metoda objektu PmaSequencer
Popis:
Předčasně uvolní čekající položky.
Syntaxe:
Long Release(Long CheckType, Long SetType, [Variant CheckVal], [Variant SetVal])
Parametry:
| CheckType | (Long) Určuje, které čekající položky se mají uvolnit
0 - uvolnit všechny položky (v tom případě parametr CheckVal nemá význam)
1,2,3 - uvolnit položky, které splňují: Val1 (2,3) = CheckVal. Je funkční pouze pokud položky jsou nezávislé (viz konfigurátor " Typ spouštění položek").
10 - uvolnit jen první položku z fronty (v tom případě parametr CheckVal nemá význam)
11,12,13 - uvolnit jen první položku z fronty, která splňuje: Val1 (2,3) = CheckVal. Je funkční pouze pokud položky jsou nezávislé (viz konfigurátor " Typ spouštění položek"). |
|---|
| SetType | (Long) Určuje, jak se mají tímto uvolněním změnit hodnoty (Val1, Val2, Val3) položky
0 - neměnit hodnoty (v tom případě parametr SetVal nemá význam)
1,2,3 - do hodnoty Val1 (2,3) uvolňované položky přiřadit hodnotu SetVal |
|---|
| CheckVal | [nepovinné] (Variant) porovnávaná hodnota, viz parametr CheckType |
|---|
| SetVal | [nepovinné] (Variant) nastavovaná hodnota, viz parametr SetType |
|---|
Vrácená hodnota:
Vrací počet uvolněných položek
Poznámka:
Položky se do fronty přidávají metodou
Add a tam se zařazují podle času uvolnění (první položka ve frontě je ta, která se má nejprve uvolnit). Položka se z fronty uvolní až jí vyprší čas nebo po zavolání metody
Release. Každá uvolněná položka zavolá událost
onStep. Metoda
Release může uvolnit i více položek, a tehdy je vyvolána událost
onStep vícekrát (pro každou uvolněnou položku jednou).
Skript v události
onStep se
nevyvolá okamžitě (a tedy nezpůsobí přerušení aktivního skriptu, ve kterém se volá metoda
Release) ale zavolá se až po ukončení aktivního skriptu.
Příklad1:
Uvolní z fronty všechny položky
JavaScriptVBScriptVyber a zkopíruj do schránky
var oSequencer = pMe.Pm("/Sequencer");
oSequencer.Release(0);
Dim oSequencer
Set oSequencer = pMe.Pm("/Sequencer")
oSequencer.Release 0Příklad2:
Uvolní z fronty všechny položky, které mají hodnotu Val1="ID1"
JavaScriptVBScriptVyber a zkopíruj do schránky
var oSequencer = pMe.Pm("/Sequencer");
oSequencer.Release(1, 0, "ID1");
Dim oSequencer
Set oSequencer = pMe.Pm("/Sequencer")
oSequencer.Release 1, 0, "ID1"