SetGadgetItemState()

Syntax

SetGadgetItemState(#Gadget, Eintrag, Status)

Ändert den Status des angegebenen Gadget-Eintrags.

Parameter

#Gadget	Das zu verwendende Gadget.
Eintrag	Der zu verwendende Eintrag. Der erste Eintrag im Gadget hat den Index 0.
Status	Der neue Status des Eintrags. Siehe unten für die Bedeutung dieses Parameters.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Dies ist eine universelle Funktion, welche zusammen mit den meisten Gadgettypen, die mehrere Einträge verwalten, arbeitet.

'Status' kann die folgenden Werte annehmen:
- CalendarGadget(): #PB_Calendar_Bold, um ein Datum in Fettschrift darzustellen, andernfalls #PB_Calendar_Normal.
- ExplorerListGadget(): mit dem folgenden Wert:

  #PB_Explorer_Selected : der Eintrag soll ausgewählt sein.

- ListViewGadget(): 1, wenn der Eintrag ausgewählt sein soll, sonst 0.
- ListIconGadget(): eine Kombination der folgenden Werte:

  #PB_ListIcon_Selected : der Eintrag soll ausgewählt sein.
  #PB_ListIcon_Checked  : der Eintrag soll mit einem Häkchen versehen werden (nur mit #PB_ListIcon_CheckBoxes Flag).
  #PB_ListIcon_Inbetween: die Checkbox (Häkchen) des Eintrags soll den "Dazwischen"-Status annehmen (nur mit #PB_ListIcon_ThreeState Flag).

- TreeGadget(): eine Kombination der folgenden Werte:

  #PB_Tree_Selected  : der Eintrag soll ausgewählt sein.
  #PB_Tree_Expanded  : der Eintrag soll ausgeklappt (ein Baum-Knoten geöffnet) sein. 
  #PB_Tree_Collapsed : der Eintrag soll eingeklappt werden. Wenn weder #PB_Tree_Expanded noch #PB_Tree_Collapsed 
                      angegeben wird, wird dieser Status nicht verändert.
  #PB_Tree_Checked   : die Häkchen-Box des Eintrags soll ein Häkchen erhalten.
  #PB_Tree_Inbetween : die Häkchen-Box des Eintrags soll im "Dazwischen"-Status sein.

  SetGadgetItemState(0, 1, #PB_Tree_Expanded | #PB_Tree_Selected) ; Der zweite Eintrag ist ausgewählt und aufgeklappt.

Siehe auch

GetGadgetItemState(), GetGadgetState(), SetGadgetState()

Unterstützte OS

Alle