ExplorerComboGadget

ExplorerComboGadget()

Syntax

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

Description

Erstellt eine ComboBox (Auswahl-Gadget), welche ein Verzeichnis und seine übergeordneten Verzeichnisse anzeigt, damit der Anwender eines davon auswählen kann. Sie können solch eine ComboBox zum Beispiel beim OpenFileRequester() finden.

Parameters

#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 (muss als vollständiger Pfad angegeben werden) - ein leerer String spezifiziert das Stammverzeichnis (Root).

Wenn das #PB_Explorer_DrivesOnly Flag gesetzt ist, darf 'Verzeichnis$' nur ein Laufwerksbuchstabe sein. Alles, was dem Laufwerksbuchstaben folgt, wird in diesem Fall ignoriert.
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_DrivesOnly          : Das Gadget zeigt nur Laufwerke zur Auswahl an.
  #PB_Explorer_Editable            : Das Gadget ist editierbar mit einem "Autocomplete" (automatisches
                                     Vervollständigen) Feature. Mit diesem Flag gesetzt, verhält sich
                                     das Gadget exakt so wie das im Windows-Explorer.
  #PB_Explorer_NoMyDocuments       : Das 'Eigene Dateien' Verzeichnis wird nicht als separater Eintrag angezeigt.

Return value

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.

Remarks

Die folgenden Funktionen können verwendet werden, um das Gadget zu steuern:

- GetGadgetText(): Ermittelt das aktuell angezeigte Verzeichnis. Benutzen Sie dies zur Überprüfung, was der Anwender ausgewählt hat, nachdem Sie ein Ereignis (Event) für dieses Gadget erhalten haben.
- SetGadgetText(): Ändert das aktuell angezeigte Verzeichnis.

Example

  If OpenWindow(0, 0, 0, 400, 45, "ExplorerComboGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ExplorerComboGadget(0, 10, 10, 380, 25, GetHomeDirectory(), #PB_Explorer_Editable)
    Repeat 
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

See Also

GetGadgetText(), SetGadgetText(), ExplorerListGadget(), ExplorerTreeGadget(), ComboBoxGadget()

Supported OS

All

<- EditorGadget() - Gadget Index - ExplorerListGadget() ->

#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 (muss als vollständiger Pfad angegeben werden) - ein leerer String spezifiziert das Stammverzeichnis (Root). Wenn das #PB_Explorer_DrivesOnly Flag gesetzt ist, darf 'Verzeichnis$' nur ein Laufwerksbuchstabe sein. Alles, was dem Laufwerksbuchstaben folgt, wird in diesem Fall ignoriert.
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_DrivesOnly : Das Gadget zeigt nur Laufwerke zur Auswahl an. #PB_Explorer_Editable : Das Gadget ist editierbar mit einem "Autocomplete" (automatisches Vervollständigen) Feature. Mit diesem Flag gesetzt, verhält sich das Gadget exakt so wie das im Windows-Explorer. #PB_Explorer_NoMyDocuments : Das 'Eigene Dateien' Verzeichnis wird nicht als separater Eintrag angezeigt.