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

Napíšte komentár