OnExternalEvent
Funkcia
Akcia definuje obslužnú procedúru udalosti generovanej externou knižnicou.
Deklarácia
ON externalEvent GOTO procName [PRTY prtyIdent] Parametre
externalEvent | in | Textová konštanta určujúca názov udalosti generovanej externou knižnicou. |
procName | in | Meno RPC alebo RPCX procedúry v ESL skripte. Procedúra musí mať jeden parameter typu štruktúrovaná premenná. Obsah tejto štruktúrovanej premennej je závislý na konkrétnej obsluhovanej externej udalosti. |
prtyIdent | in | Nepovinný parameter typu Int. Priorita pri volaní RPC. |
Popis
Akcia špecifikuje procedúru (prostredníctvom mena procName), ktorá bude zavolaná, ak sa v externej knižnici vygeneruje udalosť s daným menom. Volaná procedúra musí byť definovaná v ESL skripte, ktorý je vykonávaný na tom istom procese ako skript, ktorý pracuje s externými funkciami knižnice. V prípade definovania obsluhy rovnakej externej udalosti vo viacerých ESL skriptoch bude informácia o udalosti rozposlaná na všetky. Kľúčové slovo PRTY umožňuje zadanie priority vykonania registrovanej RPC procedúry. Táto vlastnosť zabezpečí prioritné vykonanie registrovanej RPC procedúry. Zoznam generovaných udalostí a popis ich parametrov je súčasťou dokumentácie dodávaných rozširujúcich knižníc systému D2000.
Príklad
; funkcia, ktorá spracuje informáciu o udalosti
RPC PROCEDURE OnExternalEvent (IN RECORD NOALIAS (SD.ExternalEventParams) _params
END OnExternalEvent
BEGIN
; registrácia obsluhy udalosti s názvom "ExternalEvent"
ON "ExternalEvent" GOTO OnExternalEvent
END