Funkcia %HI_FindItemData

Funkcia

Funkcia slúži na prehľadávanie užívateľských dát v položkách Windows prvku typu Strom.

Deklarácia

INT %HI_FindItemData(
   INT in refId,
   INT in root,
   INT in itemHandle,
   INT in position,
   INT in data,
 )

Parametre

refId	Odkaz na Windows prvok (referenčná premenná).
root	Identifikátor položky - vetva, ktorá sa bude prehľadávať. Ak je hodnota parametra 0, prehľadáva sa celý strom.
item	Identifikátor položky vo vetve - od tejto položky sa prehľadáva (táto už nie). Ak je hodnota parametra 0, prehľadáva sa celá vetva.
position	Pozícia dát na položke (1 ... 15).
data	Hľadané dáta (ľubovoľného typu).

Popis

Každá položka vo Windows prvku typu Strom obsahuje pole 15-tich hodnôt, ktoré môže užívateľ nastavovať a čítať pomocou funkcií %HI_GetItemData a %HI_SetItemData. Význam týchto hodnôt nie je daný a nemajú vplyv na chovanie položky stromu.

Funkcia %HI_FindItemData umožňuje prehľadávať dáta obsiahnuté v položkách Windows prvku typu Strom.

Windows prvok je identifikovaný referenčnou premennou refId.
Parameter root umožňuje špecifikovať vetvu stromu a parameter item určuje položku, od ktorej sa prehľadáva vo vetve.
Pozícia dát na položke je definovaná parametrom position a samotné dáta, ktoré sa majú hľadať sú špecifikované parametrom data.
Typ hodnoty parametra data je ľubovoľný okrem štruktúry.

Návratová hodnota funkcie %HI_FindItemData je identifikátor položky v strome, ktorá obsahuje hľadané dáta.

Príklad

Na nasledovnom obrázku je zobrazený strom.

1. Prehľadanie celého stromu, hľadané dáta sú "888" na 5. pozícii.

 %HI_FindItemData(_tree, 0, 0, 5, 888)

2. Prehľadanie vetvy 1, vrátane položky 1, hľadané dáta sú "Zilina" na 10. pozícii.

 %HI_FindItemData(_tree, 1, 0, 10, "Zilina")

3. Prehľadanie vetvy 1 od položky 1.2 (táto sa nebude prehľadávať), hľadané dáta sú "Martin" na 1. pozícii.

 %HI_FindItemData(_tree, 1, 12, 1, "Martin")

Súvisiace stránky:

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