Funkcia %HI_AddTreeItem

Funkcia

Funkcia pridá položku do Windows prvku typu Strom (Riadiaca funkcia).

Deklarácia

%HI_AddTreeItem(
   INT in refId,
   TEXT in itemText,
   INT in parentHandle,
   INT in itemHandle
   [, INT in insertAfterHandle]
 )

Parametre

refId	Odkaz na Windows prvok typu Strom (referenčná premenná).
itemText	Text položky.
parentHandle	Identifikátor položky alebo 0.
itemHandle	Identifikátor novej položky.
inserAfterHandle	Nepovinný parameter. Identifikátor položky, za ktorou sa vloží nová položka. Ak je jeho hodnota 0, položka sa vloží na koniec (rovnako ako keď parameter nie je uvedený). Ak je hodnota parametra -1, vkladaná položka bude vložené na začiatok.

Popis

Funkcia pridá položku do Windows prvku typu Strom, ktorý je identifikovaný referenčnou premennou refId. Každá položka je identifikovaná celočíselnou hodnotou, ktorá je zadaná pri jej vkladaní (itemHandle). Táto sa používa vždy pri ľubovoľnom odkaze na ňu v ďalších funkciách. Preto je nutné, aby nijaké dve položky nemali rovnaký identifikátor.

Parameter itemText určuje text, ktorý bude zobrazený v rámci položky.

Parameter parentHandle identifikuje položku nadradenú vkladanej položke. Ak je jeho hodnota 0, vkladaná položka sa považuje za koreňovú.

Akcia vkladá novú položku na koniec aktuálnej úrovne (tá je daná parametrom parentHandle). Ak je potrebné ju vložiť za konkrétnu, je ju potrebné identifikovať posledným parametrom insertAfterHandle.

Príklad

Naplnenie Windows prvok typu Strom nasledovne:

 ; dve koreňové položky
 %HI_AddTreeItem(_tree, "10", 0, 10)
 %HI_AddTreeItem(_tree, "20", 0, 20)
 ;
 %HI_AddTreeItem(_tree, "11", 10, 11)
 %HI_ExpandItem(_tree, 10, @TRUE)

Referenčná premenná _tree identifikuje Windows prvok typu Strom.

Súvisiace stránky:

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