Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben.
Verzeichnis$ ist das zu Beginn angezeigte 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' sind optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
#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.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.
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.Beispiel:
If OpenWindow(0,0,0,300,300,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ExplorerTreeGadget") And CreateGadgetList(WindowID(0))
ExplorerTreeGadget(0, 10, 10, 280, 280, "*.pb;*.pbi")
Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
EndIf
