Akcia OPENEVENT


Funkcia
Otvorenie a štart Server Eventu a Klient a Server Eventu.
Deklarácia


OPENEVENT refToServerEvent DIRECT [INSTANCE instanceExprInt] [SYNC]


 


alebo


 



OPENEVENT refToServerEvent ON procIdent [INSTANCE instanceExprInt] [SYNC]


Parametre


refToServerEventinOdkaz na Server Event alebo Klient a Server Event.
instanceExprIntinVýraz typu Int - číslo inštancie.
procIdentinIdentifikátor objektu typu Proces (D2000 HI alebo D2000 EventHandler).


Popis
Akcia otvorí a spustí Server Event alebo Klient a Server Event (refToServerEvent) v procese D2000 HI alebo D2000 Event Handler danom parametrom procIDent.
Otvorenie a spustenie Klient a Server Eventu je možné iba v procese D2000 HI danom parametrom procIDent.

Pri otvorení je možné špecifikovať číslo inštancie (parameter instanceExprInt) a tým dosiahnuť viacnásobné otvorenie Server Eventu alebo Klient a Server Eventu v rámci daného procesu.

V prípade použitia kľúčového slova SYNC, bude akcia ukončená až po skutočnom otvorení eventu. Po jej ukončení je možné volať RPC procedúry do otvoreného eventu.
 



 INT _hbj     ; jednoznačný identifikátor procesu
 
 TEXT _desc
 ;
 OPENEVENT E.Lib1 ON (_hbj) SYNC
 ; volanie
 CALL [E.Lib1] GetDesc(_desc) ON (_hbj) 


 


Akcia skončí s chybou v prípade, ak je uvedené kľúčové slovo SYNC a:
  • event E.Lib1 nie je Server Event alebo Klient a Server Event,
  • event E.Lib1 je Server Event a proces identifikovaný parametrom _hbj nie je typu D2000 HI alebo D2000 Event Handler alebo daný proces nebeží,
  • event E.Lib1 je Klient a Server Event a proces identifikovaný parametrom _hbj nie je typu D2000 HI, alebo daný proces nebeží.
Akcia nebude úspešná, ak požaduje otvorenie inštancie eventu na procese D2000 Event Handler, ktorý je rodičom daného eventu E.Lib1.

Akcia s klauzulou DIRECT otvorí daný event na rovnakom procese, v ktorom beží skript obsahujúci danú akciu OPENEVENT.

O zatvorenie Server Eventu alebo Klient a Server Eventu, otvoreného akciou OPENEVENT, môže požiadať jedine daný skript volaním akcie CLOSE DIRECT. Toto je možné implementovať pomocou RPC procedúry, ktorá to zabezpečí:
 



 RPC PROCEDURE Close (TEXT _desc)
   CLOSE DIRECT
 END


 


UPOZORNENIE: RPC procedúra Close musí byť volaná asynchrónne, t.j.:
 



 CALL E.Lib1 Close (_desc) ASYNC ON (_hbj) 


Poznámka
Zmena konfigurácie eventu počas behu skriptu nemá na chod žiaden vplyv.