ExplorerComboGadget()

Syntax

Result = ExplorerComboGadget(#Gadget, x, y, Width, Height, Directory$, [, Flags])

Creates a ComboBox that lets you display a path and all its parent folders, so the user can choose one of them. If #PB_Any is used as '#Gadget' parameter, the new gadget identifier will be returned as 'Result'. You can find such a ComboBox, for example, in the OpenFileRequester(). This can be a nice addition to the ExplorerListGadget().

Directory$ is the initial displayed directory (must be set as full path), an empty string specifies the root folder. If the #PB_Explorer_DrivesOnly flag is set, Directory$ may only be a drive letter. Everything that follows the drive letter in this case will be ignored.

'Flags' can be a combination of the following values:

  #PB_Explorer_DrivesOnly          : The gadget will only display drives to choose from.
  #PB_Explorer_Editable            : The gadget will be editable with an autocomplete feature. With this flag set, it acts exactly like the one in Windows Explorer.
  #PB_Explorer_NoMyDocuments       : The 'My Documents' Folder will not be displayed as a separate item.

The following functions can be used to control the gadget:

- GetGadgetText(): Get the currently displayed directory. Use this to ckeck what the user has selected after you get an event for this Gadget.
- SetGadgetText(): Changes the currently displayed directory.

Example:

  If OpenWindow(0,0,0,400,100,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ExplorerListGadget") And CreateGadgetList(WindowID(0))
    ExplorerComboGadget(0, 10, 40, 380, 200, "C:\", #PB_Explorer_Editable)
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf 

Supported OS

Windows, Linux, MacOS X