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_MultiSelect : Schaltet die Mehrfach-Selektion von Einträgen im Gadget ein. #PB_Explorer_GridLines : Zeigt Trennlinien zwischen Zeilen und Spalten an. #PB_Explorer_HeaderDragDrop : In der Report-Ansicht können die Spaltentitel per Drag'n'Drop verändert werden. #PB_Explorer_FullRowSelect : Die Auswahl erstreckt sich jetzt über die gesamte Zeile und nicht nur über die erste Spalte. #PB_Explorer_NoFiles : Es werden keine Dateien angezeigt. #PB_Explorer_NoFolders : Es werden keine Ordner angezeigt. #PB_Explorer_NoParentFolder : Es gibt keinen Verknüpfung [..] zum übergeordneten Ordner. #PB_Explorer_NoDirectoryChange : Das Verzeichnis kann durch den Anwender nicht verändert werden. #PB_Explorer_NoDriveRequester : Es wird kein 'Legen Sie bitte einen Datenträger in Laufwerk X: ein' angezeigt. #PB_Explorer_NoSort : Der Anwender kann den Inhalt nicht durch Anklicken eines Spaltentitels sortieren. #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:
- ChangeListIconGadgetDisplay(): Ändert die Anzeige genauso wie beim ListIconGadget().
- AddGadgetColumn(): Fügt eine neue - automatisch oder manuell ausgefüllte - Spalte zum Gadget hinzu. Siehe beim AddGadgetColumn() Befehl für mehr Details.
- RemoveGadgetColumn(): Entfernt eine Spalte vom Gadget.
- GetGadgetText(): Ermittelt das aktuell angezeigte Verzeichnis.
- SetGadgetText(): Ändert das aktuell angezeigte Verzeichnis, oder den aktuellen Pattern (Datei-Typ) für Dateien.
- GetGadgetState(): Ermittelt den ersten ausgewählten Eintrag (-1, wenn nichts ausgewählt ist).
- GetGadgetItemText(): Ermittelt den Namen eines Eintrags.
- SetGadgetItemText(): Ändert den Text-Inhalt eines Eintrags oder füllt eine selbsterstellte Spalte mit Daten.
- GetGadgetItemState(): Überprüft, ob ein Eintrag ein Verzeichnis oder eine Datei ist, und ob es gerade ausgewählt ist.
- CountGadgetItems(): Zählt die Einträge im aktuellen Verzeichnis.
ExplorerListGadget() unterstützt folgende Ereignisse, die von EventType() mitgeteilt werden:
#PB_EventType_Change : Die Auswahl oder das aktuell angezeigte Verzeichnis 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,400,200,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ExplorerListGadget") And CreateGadgetList(WindowID(0))
ExplorerListGadget(0, 10, 10, 380, 180, "*.*", #PB_Explorer_MultiSelect)
Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
EndIf
