Funkcia %HI_SetConnectedObj

Funkcia

Funkcia nastaví pripojený objekt pre zobrazovač typu Graf, Schéma alebo Browser.

Deklarácia

BOOL %HI_SetConnectedObj(
   INT in refId,
   HBJ in refToObj,
   INT in instanceNr
 )

Parametre

refId

Odkaz na zobrazovač (referenčná premenná).

refToObj

Odkaz na objekt systému D2000 typu Graf, Grafická schéma alebo Browser.

Poznámka: Ak je parameter neasociovaný alias, ESL skript generuje chybu Range Error (prekročenie medzí).

instanceNr

Číslo inštancie.

Poznámka: Ak je číslo inštancie záporné, proces D2000 HI generuje chybu Range Error (prekročenie medzí).

Popis

Funkcia zmení pripojený objekt v zobrazovačoch typu Graf, Report, Schéma alebo Browser.

Zobrazovač je daný parametrom refId. Parameter refToObj je výraz typu Hbj, ktorý identifikuje objekt, ktorý bude pripojený. instanceNr je číslo inštancie, v ktorej bude daný objekt otvorený.

Pre grafický zobrazovač typu Browser je možné pripojiť iba objekt typu štruktúrovaná premenná (SV.*) alebo databázovú tabuľku (DB.*). Pri zmene pripojeného objektu sa neberie do úvahy, ak boli dáta v zobrazovači Browser modifikované. To je možné zistiť funkciou %HI_GetBrowserModifyFlag.

Návratová hodnota funkcie je úspešnosť operácie. Funkcia môže byť použitá ako riadiaca alebo ako normálna. Vykonávanie funkcie bude ukončené až po vykonaní inicialiazačnej časti otváranej podschémy.

Príklad

%HI_SetConnectedObj(_Graf, D.Teploty\HBJ, 0)

alebo

 BOOL _bOk
 
 _bOk := %HI_SetConnectedObj(_Graf, S.Obrazok\HBJ, 1)
 IF _bOK THEN
   ; schéma je otvorená
 ELSE
   ; nepodarilo sa otvoriť schému
 ENDIF

kde:

_Graf	RefId zobrazovača typu Graf.
D.Teploty	Objekt typu Graf. Výraz D.Teploty\HBJ je typu Hbj (odkaz na objekt). Číslo inštancie bude 0.
S.Obrazok	Objekt typu Grafická schéma.

Súvisiace stránky:

Funkcie pre ovládanie grafických objektov
Argumenty funkcie - typy