TreeGadget

TreeGadget()

Syntax

Ergebnis = TreeGadget(#Gadget, x, y, Breite, Höhe [, Flags])

Beschreibung

Erstellt ein Tree-Gadget (Baum-Gadget) innerhalb der aktuellen Gadgetliste.

Parameter

#Gadget Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.

x, y, Breite, Höhe Die Position und die Abmessungen des neuen Gadgets.
Flags (optional)
Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein:
  #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 (Checkbox) vor jedem Eintrag hinzu.
  #PB_Tree_ThreeState          : Die Häkchen-Boxen haben einen "Dazwischen"-Status.
Das #PB_Tree_ThreeState Flag kann in Verbindung mit dem #PB_Tree_CheckBoxes Flag verwendet werden, um Checkboxen (Häkchen-Boxen) zu erhalten, welche einen "An", "Aus" und "Dazwischen" Status haben können. Der Anwender kann nur die "An"- bzw. "Aus"-Status auswählen. Der "Dazwischen"-Status kann programmseitig mittels der SetGadgetItemState() Funktion gesetzt werden.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Jeder Eintrag im Tree hat einen ihm zugewiesenen Unterebenen-Wert ("Sublevel"), welcher die Verbindung zwischen dem Eintrag darüber und darunter bestimmt. Einträge mit dem gleichen Sublevel gehören zum gleichen Knoten ("Node"), Einträge mit einem höheren Sublevel sind untergeordnete Einträge ("Childitems") und so weiter. Dieser Sublevel-Wert kann verwendet werden, um die Verbindung zwischen zwei Einträgen durch Vergleichen ihres Sublevel-Werts zu bestimmen. Der Parameter 'Flags' von AddGadgetItem() wird bei TreeGadget-Einträgen immer benötigt und wird verwendet, um den Sublevel festzulegen, an dem der neue Eintrag hinzugefügt werden soll. Beachten Sie bitte: wenn die Funktion mit einem Sublevel aufgerufen wird, an dem der Eintrag nicht hinzugefügt werden kann, dann wird der Eintrag an dem Sublevel hinzugefügt, wo dies möglich ist.

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Befehle können benutzt werden, um auf den Tree-Inhalt 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).
- ClearGadgetItems(): Entfernt alle Einträge.
- CountGadgetItems(): Ermittelt die Anzahl der aktuell im Gadget befindlichen Einträge.
- 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.
- SetGadgetItemImage(): Ändert das aktuelle Bild des angegebenen Eintrags.
- GetGadgetItemData(): Gibt den Wert zurück, welcher mit dem Eintrag gespeichert wurde.
- SetGadgetItemData(): Speichert einen Wert mit dem Eintrag.
- GetGadgetItemColor(): Gibt die Text- oder Hintergrundfarbe des Eintrags zurück.
- SetGadgetItemColor(): Ändert die Text- oder Hintergrundfarbe des Eintrags. (nicht auf MacOS X unterstützt)
- 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.
- GetGadgetItemAttribute(): Mit dem folgenden Attribut:
  #PB_Tree_SubLevel: Gibt den Sublevel-Wert des angegebenen Eintrags zurück.
- GadgetItemID(): Gibt das OS-Handle des angegebenen Eintrags zurück (nützlich für API-Funktionen).

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':
  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe
Die folgenden Ereignisse ("Events") werden durch EventType() unterstützt:
  #PB_EventType_LeftClick : linker Mausklick auf einen Eintrag, oder ein Häkchen wurde gesetzt/entfernt
  #PB_EventType_LeftDoubleClick
  #PB_EventType_RightClick
  #PB_EventType_RightDoubleClick
  #PB_EventType_Change : der aktuelle Eintrag wurde verändert
  #PB_EventType_DragStart : der Anwender versucht, eine Drag & Drop Operation zu starten
Nach einem #PB_EventType_DragStart Ereignis kann die Drag & Drop Library verwendet werden, um eine Drag & Drop Operation zu starten.

Beispiel

  If OpenWindow(0, 0, 0, 355, 180, "TreeGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    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), 0, 0) ; wenn Sie ein Bild hinzufügen möchten, dann 
        AddGadgetItem (ID, -1, "Node "+Str(a), 0, 0)        ; benutzen Sie ImageID(x) als 4. Parameter
        AddGadgetItem(ID, -1, "Sub-Item 1", 0, 1)     ; diese sind auf dem ersten Sublevel
        AddGadgetItem(ID, -1, "Sub-Item 2", 0, 1)
        AddGadgetItem(ID, -1, "Sub-Item 3", 0, 1)
        AddGadgetItem(ID, -1, "Sub-Item 4", 0, 1)
        AddGadgetItem (ID, -1, "File "+Str(a), 0, 0)  ; hier wieder Sublevel 0
      Next
    Next
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

AddGadgetItem(), RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), GetGadgetItemState(), SetGadgetItemState(), GetGadgetItemText(), SetGadgetItemText(), SetGadgetItemImage(), GetGadgetItemData(), SetGadgetItemData(), GetGadgetState(), SetGadgetState(), GetGadgetText(), SetGadgetText(), GetGadgetItemAttribute(), GadgetItemID(), GetGadgetColor(), SetGadgetColor(), ExplorerTreeGadget()

Unterstützte OS

Alle

<- TrackBarGadget() - Gadget Inhaltsverzeichnis - UnbindGadgetEvent() ->

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '\|' OR-Operator) der folgenden Konstanten sein: #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 (Checkbox) vor jedem Eintrag hinzu. #PB_Tree_ThreeState : Die Häkchen-Boxen haben einen "Dazwischen"-Status. Das #PB_Tree_ThreeState Flag kann in Verbindung mit dem #PB_Tree_CheckBoxes Flag verwendet werden, um Checkboxen (Häkchen-Boxen) zu erhalten, welche einen "An", "Aus" und "Dazwischen" Status haben können. Der Anwender kann nur die "An"- bzw. "Aus"-Status auswählen. Der "Dazwischen"-Status kann programmseitig mittels der SetGadgetItemState() Funktion gesetzt werden.