Funkcia %HI_GetSelectedItem, %HI_SetSelectedItem

Funkcia
Funkcia %HI_SetSelectedItem vyberie daný riadok (položku) Windows prvku typu Zoznam alebo Strom alebo zobrazovača typu Browser ako aktuálny (riadiaca funkcia).

Funkcia %HI_GetSelectedItem vráti index (od 1 ...) aktuálneho (vybraného) riadku (položky) z Windows prvku typu Zoznam alebo Strom alebo zo zobrazovača typu Browser.
Deklarácia
%HI_SetSelectedItem(
   INT in refId,
   INT in itemIdx,
   BOOL in bInCurrPage := @FALSE
   BOOL in bState := @TRUE
 )


 INT %HI_GetSelectedItem(
   INT in refId,
   BOOL in bInCurrPage := @FALSE
   INT in iFromIdx := 0
 )

Parametre
refId Odkaz na Windows prvok (referenčná premenná).
itemIdx Index riadku (položky).
bInCurrPage Parameter má význam len pre zobrazovač typu Browser:
  • @TRUE - parameter itemIdx označuje index prvku na aktuálne zobrazenej stránke Browsera
  • @FALSE - parameter itemIdx označuje index prvku bez ohľadu na stránkovanie (v rámci celého Browsera)
bState Parameter sa zohľadňuje iba keď je Browser v režime Multiselect:
  • @TRUE - riadok sa má označiť
  • @FALSE - riadok sa má odznačiť
iFromIdx Parameter sa používa len vtedy keď je Browser v režime Multiselect - nastavuje index, od ktorého ďalej sa bude hľadať označený riadok.

Príklad: Ak sú označené riadky 1, 3 a 5 a parameter iFromIdx je nastavený na hodnotu 3, tak funkcia vráti 5.

Poznámka
Ak nie je vybraný žiadny riadok, funkcia vráti číslo 0.

Parameter itemIdx má pre Windows prvok typu Strom význam jednoznačného identifikátora položky.

Po zavolaní funkcie %HI_SetSelectedItem na položku v Strome, ktorá je mimo zobrazovanej plochy, sa automaticky posunú rolovacie pruhy tak, aby bola vybratá položka viditeľná.


Súvisiace stránky:

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

Napíšte komentár