Funkcia %HI_PopUpMenu_AddItem

Funkcia
Funkcia %HI_PopUpMenu_AddItem pridá položku do popup menu (riadiaca funkcia).
Deklarácia
%HI_PopUpMenu_AddItem(
   INT in type,
   TEXT in text,
   INT in itemId,
   INT in parentId
   [, BOOL in bEnabled,
   BOOL in bChecked,
   HBJ in bitmapHBJ,
   HBJ in bitmapCheckedHBJ]
 )

Parametre
type Typ položky. Možné hodnoty:
  • 0 - normálna položka v menu
  • 1 - vnorené PopUp menu
  • 2 - menu separátor
text Text pridávanej položky.
itemId Jednoznačný identifikátor.
parentId Jednoznačný identifikátor existujúcej položky v nadradené menu.
bEnabled @TRUE - povolenie položky.
@FALSE - zakázanie položky.
bChecked @TRUE - označenie položky.
@FALSE - neoznačenie položky.
bitmapHBJ Objekt typu Bitová mapa.
bitmapCheckedHBJ Objekt typu Bitová mapa.

Popis
Funkcia pridá položku do popup menu. Je nutné ju volať (podľa potreby aj opakovane) po volaní funkcie %HI_PopUpMenu_Create.



Parameter type definuje typ vkladanej položky. Každá vložená položka (okrem typu separator) musí mať v rámci definovaného menu (ktoré tvorí súhrn všetkých definovaných popup menu) jednoznačný číselný identifikátor (parameter id). V prípade, že položka je vo vnorenom popup menu (napríklad položka "Text 1.1"), parameter parentId obsahuje id položky v nadradenom popup menu:
 
 ; definícia položky "Text 2"
 %HI_PopUpMenu_AddItem(1, "Text 2", 2, 0, @TRUE, @FALSE, 0, 0)

   ; definícia položky "Text 2.1"
   %HI_PopUpMenu_AddItem(0, "Text 2.1", 21, 2, @TRUE, @FALSE, 0, 0)

 
Parameter bEnabled povolí (hodnota @TRUE), alebo zakáže (hodnota @FALSE) položku. V príklade "Text 2.2.2".
Parameter bChecked označí (hodnota @TRUE) položku. V príklade "Text 2.2.1".
Parametre bitmapHBJ a bitmapCheckedHBJ sú odkazy na objekty typu Bitová mapa, ktoré budú použité (ak sú zadané) v prípade, že položka je v stave označená (checked), alebo neoznačená.

Položky definované funkciou %HI_PopUpMenu_AddItem nemusia byť usporiadané v tvare popup menu, budú usporiadané automaticky pred zobrazením menu.

Obmedzenia:
  • maximálny počet položiek v menu - 200,
  • ak sa položka odkazuje na neexistujúceho rodiča, bude zaradená do hlavného menu,
  • ak rodič položky nie je vnorené popup menu, bude položka zaradená do hlavného menu,
  • ak je rodič položky tá istá položka (odkazuje sama na seba), bude zaradená do hlavného menu,
  • v prípade výskytu viacerých položiek s rovnakým parametrom id, bude rodič prvá dodaná položka,
  • poradie položiek v hlavnom i vnorených menu je dané príchodom ich definícií - definície môžu byť prekladané inými položkami,
  • zacyklené odkazy budú vyradené z menu (vrátane vnorených menu) a zobrazí sa chybová správa.

Príklad
Nasledujúci príklad popisuje skript, ktorý vytvorí a zobrazí popup menu zobrazené na obrázku vyššie.

 
 ; vytvorenie prázdneho popup menu
 %HI_PopUpMenu_Create(300,300)
 
 %HI_PopUpMenu_AddItem(0, "Text 1", 1, 0, @TRUE, @FALSE, 0, 0)
 %HI_PopUpMenu_AddItem(1, "Text 2", 2, 0, @TRUE, @FALSE, 0, Bitmapa.BMP\HBJ)
 
   %HI_PopUpMenu_AddItem(0, "Text 2.1", 21, 2, @TRUE, @FALSE, 0, 0)
 
     %HI_PopUpMenu_AddItem(0, "Text 2.1.1", 211, 21, @TRUE, @FALSE, 0, 0)
     %HI_PopUpMenu_AddItem(0, "Text 2.1.2", 212, 21, @TRUE, @FALSE, 0, 0)
 
   %HI_PopUpMenu_AddItem(1, "Text 2.2", 22, 2, @TRUE, @FALSE, 0, 0)
 
     %HI_PopUpMenu_AddItem(0, "Text 2.2.1", 221, 22, @TRUE, @TRUE, 0, 0)
     %HI_PopUpMenu_AddItem(0, "Text 2.2.2", 222, 22, @FALSE, @FALSE, 0, 0,)
 
   %HI_PopUpMenu_AddItem(0, "Text 2.3", 23, 2, @TRUE, @FALSE, 0, 0)
 
 %HI_PopUpMenu_AddItem(2, "Text 3", 3, 0, @TRUE, @FALSE, 0, 0)
 %HI_PopUpMenu_AddItem(0, "Text 4", 4, 0, @TRUE, @FALSE, 0, 0)
 
 ; zobrazenie popup menu
 %HI_PopUpMenu_Show()

Funkcie pre ovládanie aktívnej schémy
Indexové lokálne premenné
Argumenty funkcie - typy