GetGadgetItemState()

Syntax

Ergebnis = GetGadgetItemState(#Gadget, Eintrag)
Beschreibung
Gibt den Status eines Eintrags im angegebenen Gadget zurück.

Parameter

#Gadget Das zu verwendende Gadget.
Eintrag Der Eintrag, von dem der Status ermittelt werden soll. Der erste Eintrag im Gadget hat den Index 0.

Rückgabewert

Gibt den Status des Gadget-Eintrags zurück - oder 0, wenn dabei ein Fehler auftrat. Siehe unten für die Bedeutung dieses Wertes, abhängig vom Gadgettyp.

Anmerkungen

Dies ist eine universelle Funktion, welche zusammen mit den meisten Gadgets arbeitet, die mehrere Einträge verwalten:
- CalendarGadget(): gibt #PB_Calendar_Bold zurück, wenn das angegebene Datum in "fett" dargestellt wird, andernfalls #PB_Calendar_Normal. 'Eintrag' muss ein PureBasic Datums-Wert sein.
- ExplorerListGadget(): gibt eine Kombination der folgenden Werte zurück:
  #PB_Explorer_File      : Der Eintrag ist eine Datei.
  #PB_Explorer_Directory : Der Eintrag ist ein Verzeichnis (oder ein Laufwerk).
  #PB_Explorer_Selected  : Der Eintrag ist aktuell ausgewählt.
- ListViewGadget(): gibt 1 zurück, wenn der Eintrag ausgewählt ist, andernfalls 0.
- ListIconGadget(): gibt eine Kombination der folgenden Werte zurück:
  #PB_ListIcon_Selected : Der 'Eintrag' ist ausgewählt
  #PB_ListIcon_Checked  : Der 'Eintrag' ist mit einem Häkchen versehen (#PB_ListIcon_CheckBoxes Flag).
  #PB_ListIcon_Inbetween: Die Häkchen-Box des Eintrags befindet sich im "Dazwischen"-Status (nur mit #PB_ListIcon_ThreeState Flag).
- TreeGadget(): gibt eine Kombination der folgende Werte zurück:
  #PB_Tree_Selected  : Der Eintrag ist ausgewählt, andernfalls 0.
  #PB_Tree_Expanded  : Der Eintrag ist ausgeklappt (ein "Baum"-Eintrag ist geöffnet), andernfalls 0.
  #PB_Tree_Collapsed : Der Eintrag ist nicht ausgeklappt (der "Baum"-Eintrag geschlossen).
  #PB_Tree_Checked   : Das Häkchen bei einem Eintrag ist gesetzt, andernfalls 0 (nur mit #PB_Tree_CheckBoxes Flag).
  #PB_Tree_Inbetween : Das Häkchen bei einem Eintrag befindet sich im "Dazwischen"-Status (nur mit #PB_Tree_ThreeState Flag).
Überprüfen Sie den Status wie bei folgendem Beispiel:
  If Ergebnis & #PB_Tree_Checked
    ; Eintrag ist mit Häkchen versehen
  EndIf

Beispiel

Nachfolgend noch anhand des ListIconGadget() ein Beispiel, wie ggf. eine Kombination mehrerer Ergebnisse abgefragt werden kann:
  ; ... hier ein Ausschnitt aus einer WaitWindowEvent() - Ereignis-Warteschlange:
  If GetGadgetItemState(#Listicon, n) & #PB_ListIcon_Checked
    ; Eintrag n ist abgehakt (egal ob ausgewählt oder nicht) 
  EndIf 
  
  If GetGadgetItemState(#Listicon, n) & #PB_ListIcon_Selected
    ; Eintrag n ist ausgewählt (egal ob abgehakt oder nicht) 
  EndIf 
  
  If GetGadgetItemState(#Listicon, n) = #PB_ListIcon_Checked | #PB_ListIcon_Selected 
    ; Eintrag n ist abgehakt UND ausgewählt
  EndIf 
  
  If GetGadgetItemState(#Listicon, n) & (#PB_ListIcon_Checked | #PB_ListIcon_Selected)
    ; Eintrag n ist abgehakt ODER ausgewählt ODER beides 
  EndIf

Siehe auch

SetGadgetItemState(), GetGadgetState(), SetGadgetState()

Unterstützte OS

Alle

<- GetGadgetItemData() - Gadget Inhaltsverzeichnis - GetGadgetItemText() ->