Funkcia %HI_SetConnectedObj

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

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

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í).

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.

%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.