ExplorerListGadget

ExplorerListGadget()

Syntax

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

Beschreibung

Erstellt eine Auflistung eines Verzeichnisses, genau wie der Explorer dies tut. Es ermöglicht dem Anwender, eine Datei oder ein Verzeichnis auszuwählen, und (wenn Sie dies nicht mit einem Flag verhindern) durch den gesamten Verzeichnisbaum zu navigieren.

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 anfänglich 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 (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_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 keine 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.
  #PB_Explorer_HiddenFiles         : Zeigt auch versteckte Dateien (nur auf Linux und OS X unterstützt).

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:

- 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 (oder des Spaltentitels, wenn Eintrag = -1).
- SetGadgetItemText(): Ändert den Text-Inhalt eines Eintrags (oder des Spaltentitels, wenn Eintrag = -1) 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.
- SetGadgetItemState(): Ändert den Auswahl-Status des angegebenen Eintrags.
- CountGadgetItems(): Zählt die Einträge im aktuellen Verzeichnis.
- GetGadgetAttribute() / SetGadgetAttribute(): Mit den folgenden Attributen:
  #PB_Explorer_DisplayMode : Ermittelt bzw. ändert den Anzeigemodus des Gadgets. Kann eine der folgenden Konstanten sein (nur auf Windows):
    #PB_Explorer_LargeIcon: großer Icon-Modus
    #PB_Explorer_SmallIcon: kleiner Icon-Modus
    #PB_Explorer_List     : Listen-Icon-Modus
    #PB_Explorer_Report   : Report-Modus (Spalten, Standardmodus)
- GetGadgetItemAttribute() / SetGadgetItemAttribute(): Mit den folgenden Attributen:
  #PB_Explorer_ColumnWidth : Gibt die Breite der angegebenen 'Spalte' zurück bzw. ändert diese. Der 'Eintrag'
                                     Parameter wird ignoriert.
Dieses Gadget unterstützt die Befehle SetGadgetColor() und GetGadgetColor() mit den folgenden Werten als 'FarbTyp':
  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe
  #PB_Gadget_LineColor : Farbe der Gitterlinien, wenn der #PB_Explorer_GridLines Flag verwendet wird.
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.
  #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, 400, 200, "ExplorerListGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ExplorerListGadget(0, 10, 10, 380, 180, "*.*", #PB_Explorer_MultiSelect)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

AddGadgetColumn(), RemoveGadgetColumn(), GetGadgetText(), SetGadgetText(), GetGadgetState(), GetGadgetItemState(), GetGadgetItemText(), SetGadgetItemText(), CountGadgetItems(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetItemAttribute(), SetGadgetItemAttribute(),SetGadgetColor(), SetGadgetItemState(), GetGadgetColor(), ExplorerComboGadget(), ExplorerTreeGadget(), ListIconGadget()

Unterstützte OS

Alle

<- ExplorerComboGadget() - Gadget Inhaltsverzeichnis - ExplorerTreeGadget() ->

#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 anfänglich 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 (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_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 keine 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. #PB_Explorer_HiddenFiles : Zeigt auch versteckte Dateien (nur auf Linux und OS X unterstützt).