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

Napíšte komentár