Funkcia %HI_GetMasterEnable, %HI_SetMasterEnable

Funkcia

Funkcia %HI_SetMasterEnable zakáže prístup k objektu (preťaží funkciu %HI_SetEnable) / zruší zákaz a povolí možnosť ovládania zobrazenia grafického objektu funkciou %HI_SetEnable (riadiaca funkcia).

Funkcia %HI_GetMasterEnable zístí aktuálny stav preťaženia objektu nastavený funkciou %HI_GetMasterEnable.

Deklarácia

%HI_SetMasterEnable(
   INT in refId,
   BOOL in bEnable
 )
 
 
 BOOL %HI_GetMasterEnable(
   INT in refId
 )

Parametre

refId	Odkaz na grafický objekt (referenčná premenná).
bEnable	@TRUE - povolenie grafického objektu @FALSE - zakázanie grafického objektu

Popis

Funkcia %HI_SetMasterEnable umožňuje zakázať grafické objekty alebo záložky objektu Windows prvku Záložky - parameter refId určuje názov referenčnej premennej daného grafického objektu alebo názov referenčnej premennej danej záložky. Táto funkcia pri parametri @FALSE preťažuje funkciu %HI_SetEnable (blokuje jej funkčnosť).

Funkcia %HI_GetMasterEnable získava aktuálny stav preťaženia objektu nastaveného funkciou %HI_SetMasterEnable. Pozor návratová hodnota @TRUE neznamená, že je objekt povolený, ale že riadenie objektu má funkcia %HI_SetEnable. Návratová hodnota @FALSE znamená, že riadenie objektu funkciou %HI_SetEnable bolo zablokované a objekt nie je povolený.

Popis správania sa master funkcií je detailnejšie popísaný v kapitole Master funkcie.

Príklad

 ENTRY OnLogOn(IN TEXT _userName, IN BOOL _bLogOn)
   IF _bLogOn THEN
 
    ;pri prihlásenom užívateľovi objekt môže byť povolený
    %HI_SetMasterEnable(_Text,@TRUE)
  ELSE
 
    ;pri odhlásenom užívateľovi je prístup k objektu zakázaný
    %HI_SetMasterEnable(_Text,@FALSE)
  ENDIF
 END OnLogOn

Poznámka

Táto funkcia je dostupná aj v %HIX_ verzii.

Súvisiace stránky:

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