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() ->