Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben. #Gadget ist die Nummer, die (später) von der EventGadgetID() Funktion zurückgegeben wird.
'Flags' sind optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
#PB_Tree_AlwaysShowSelection : Die Auswahl ist noch sichtbar, auch wenn das Gadget nicht aktiviert ist.
#PB_Tree_NoLines : Versteckt die kleinen Linien zwischen allen Knoten ("Nodes").
#PB_Tree_NoButtons : Versteckt die '+' Knoten ("Node") Schalter.
#PB_Tree_CheckBoxes : Fügt ein Häkchen vor jedem Eintrag ein.
Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.
Sobald ein Tree (Baum) erstellt wurde, ist seine Liste mit Einträgen leer.
Die folgenden Befehle können benutzt werden, um auf den Listeninhalt zuzugreifen:
- AddGadgetItem(): Fügt einen Eintrag (mit optionalem Bild in der 16x16 Standard Icon-Größe) hinzu.
- RemoveGadgetItem(): Entfernt einen Eintrag (und all seine Untereinträge).
- ClearGadgetItemList(): Entfernt alle Einträge.
- CountGadgetItems(): Ermittelt die Anzahl der aktuellen Einträge im #Gadget.
- GetGadgetItemState(): Ermittelt den aktuellen Status des angegebenen Eintrags.
- SetGadgetItemState(): Ändert den aktuellen Status des angegebenen Eintrags.
- GetGadgetItemText(): Ermittelt den aktuellen Textinhalt des angegebenen Eintrags.
- SetGadgetItemText(): Ändert den aktuellen Text des angegebenen Eintrags.
- GetGadgetState(): Ermittelt den aktuell ausgewählten Eintrag.
- SetGadgetState(): Ändert den aktuell ausgewählten Eintrag.
- GetGadgetText(): Ermittelt den Textinhalt des aktuell ausgewählten Eintrags.
- SetGadgetText(): Ändert den Textinhalt des aktuell ausgewählten Eintrags.
- OpenTreeGadgetNode(): Öffnet einen neuen Knoten (Node) für Untereinträge im #Gadget.
- CloseTreeGadgetNode(): Schließt einen offenen Knoten (Node) im #Gadget.
- CountTreeGadgetNodeItems(): Ermittelt die Anzahl an Untereinträgen, welche der angegebene Eintrag hat.
- GadgetItemID(): Gibt das OS-Handle (nützlich für die Verwendung von API-Funktionen) des angegebenen Eintrags zurück.
- TreeGadgetItemNumber(): Gibt die Eintrag-Nummer des angegebenen OS-Eintrag-Handle (nützlich für die Verwendung von API-Funktionen) zurück.
Beispiel:
If OpenWindow(0,0,0,355,180,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"TreeGadget") And CreateGadgetList(WindowID(0))
TreeGadget(0, 10,10,160,160) ; TreeGadget Standard
TreeGadget(1,180,10,160,160,#PB_Tree_CheckBoxes|#PB_Tree_NoLines) ; TreeGadget mit Checkboxen + ohne Linien
For ID=0 To 1
For a=0 To 10
AddGadgetItem (ID, -1, "Normal Item "+Str(a)) ; wenn Sie ein Bild hinzufügen möchten, dann
AddGadgetItem (ID, -1, "Node "+Str(a)) ; benutzen Sie UseImage(x) als 4. Parameter
OpenTreeGadgetNode(ID)
AddGadgetItem(ID, -1, "Sub-Item 1")
AddGadgetItem(ID, -1, "Sub-Item 2")
AddGadgetItem(ID, -1, "Sub-Item 3")
AddGadgetItem(ID, -1, "Sub-Item 4")
CloseTreeGadgetNode(ID)
AddGadgetItem (ID, -1, "File "+Str(a))
Next
Next
Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
EndIf
