ExplorerTreeGadget()

Syntax

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

Erstellt eine Baum-Ansicht (englisch: "Tree") eines Verzeichnis-Baums, genau wie der Explorer dies tut. Es ermöglicht dem Anwender, durch sein Dateisystem zu navigieren und eine Datei oder ein Verzeichnis auszuwählen.

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.
Verzeichnis$	Das zu Beginn ausgewählte Verzeichnis. Es kann einen oder mehrere Pattern (Datei-Typen) beinhalten, wie z.B. "C:\*.pb;*.pbi". Wird kein Pattern mit angegeben, muss das Verzeichnis mit einem '\' enden. Ist kein Verzeichnis angegeben, wird das Stammverzeichnis einschließlich der Laufwerke angezeigt. Ohne Angabe eines Pattern wird dieser standardmäßig auf '*.*' gesetzt. Wenn also 'Verzeichnis$' gleich "" ist, wird das Stammverzeichnis angezeigt und '*.*' (alle Dateien) als Pattern gesetzt.
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_Explorer_BorderLess : Erstellt Gadget ohne Ränder. #PB_Explorer_AlwaysShowSelection : Die Auswahl ist sichtbar, auch wenn das Gadget nicht aktiv ist. #PB_Explorer_NoLines : Versteckt die kleinen Linien zwischen den Knoten. #PB_Explorer_NoButtons : Versteckt die '+' Knoten-Schalter. #PB_Explorer_NoFiles : Es werden keine Dateien angezeigt. #PB_Explorer_NoDriveRequester : Es wird kein 'Legen Sie bitte einen Datenträger in Laufwerk X: ein' angezeigt. #PB_Explorer_NoMyDocuments : Das 'Eigene Dateien' Verzeichnis wird nicht als ein separater Eintrag angezeigt. #PB_Explorer_AutoSort : Der Inhalt wird automatisch nach dem Namen sortiert.

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

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

Die folgenden Funktionen können zum Kontrollieren des Gadgets verwendet werden:

- GetGadgetText(): Ermittelt den vollständigen Pfad des/der aktuell ausgewählten Verzeichnisses/Datei.
- SetGadgetText(): Ändert die/das aktuell ausgewählte Datei/Verzeichnis.
- GetGadgetState(): Überprüft, ob der ausgewählte Eintrag eine Datei oder ein Verzeichnis ist.

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':

  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe
  #PB_Gadget_LineColor : Farbe der Linien und Schalter, wenn sie dargestellt werden

ExplorerTreeGadget() unterstützt folgende Ereignisse, die von EventType() mitgeteilt werden:

  #PB_EventType_Change           : Die Auswahl wurde verändert.
  #PB_EventType_LeftClick        : Der Anwender hat einen Eintrag mit der linken Maustaste angeklickt.
  #PB_EventType_RightClick       : Der Anwender hat einen Eintrag mit der rechten Maustaste angeklickt.
  #PB_EventType_LeftDoubleClick  : Der Anwender hat einen Eintrag mit der linken Maustaste doppelt angeklickt.
  #PB_EventType_RightDoubleClick : Der Anwender hat einen Eintrag mit der rechten Maustaste doppelt angeklickt.
  #PB_EventType_DragStart        : Der Anwender versucht, eine Drag & Drop Operation zu starten.

Nach einem #PB_EventType_DragStart Ereignis kann die Drag & Drop Bibliothek verwendet werden, um eine Drag & Drop Operation zu starten.

Beispiel

  If OpenWindow(0, 0, 0, 300, 300, "ExplorerTreeGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ExplorerTreeGadget(0, 10, 10, 280, 280, "*.pb;*.pbi")
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetText(), SetGadgetText(), GetGadgetState(), GetGadgetColor(), SetGadgetColor(), ExplorerComboGadget(), ExplorerListGadget(), TreeGadget()

Unterstützte OS

Alle