SelectFolder |

Funktionsname | dcl_SelectFolder
Syntax | `(dcl_SelectFolder Title [as String] {DefaultDirectory [as String]} {RootFolder [as String]} {Flags [as BitFlag]})`
Rückgabewert | String

This function prompts the user to select a folder. The function returns the name of the selected folder, or NIL if the dialog is cancelled. The default value for Flags is 1 if it is omitted.

Flags Value | Bit | Meaning
--- | --- | ---
1 | 0 | Only return file system directories. If the user selects folders that are not part of the file system, the OK button is disabled.
2 | 1 | Do not include network folders below the domain level in the dialog box's tree view control.
4 | 2 | Include a status area in the dialog box. The callback function can set the status text by sending messages to the dialog box. This flag is not supported when 6 is set.
8 | 3 | Only return file system ancestors. An ancestor is a subfolder that is beneath the root folder in the namespace hierarchy. If the user selects an ancestor of the root folder that is not part of the file system, the OK button is disabled.
16 | 4 | Include an edit control in the browse dialog box that allows the user to type the name of an item.
32 | 5 | Not used.
64 | 6 | Use the new user interface. Setting this flag provides the user with a larger dialog box that can be resized. The dialog box has several new capabilities, including: drag-and-drop capability within the dialog box, reordering, shortcut menus, new folders, delete, and other shortcut menu commands.
128 | 7 | The browse dialog box can display URLs. Bits 6, 4, and 13 must also be set. If any of these bits are not set, the browser dialog box rejects URLs. Even when these bits are set, the browse dialog box displays URLs only if the folder that contains the selected item supports URLs.
256 | 8 | When combined with bit 6, adds a usage hint to the dialog box, in place of the edit box. Bit 4 overrides this bit.
512 | 9 | Do not include the New Folder button in the browse dialog box.
1024 | 10 | When the selected item is a shortcut, return the name of the shortcut itself rather than its target.
2048 | 11 | Only return computers. If the user selects anything other than a computer, the OK button is disabled.
4096 | 12 | Only allow the selection of printers. If the user selects anything other than a printer, the OK button is disabled.
8192 | 13 | The browse dialog box displays files as well as folders.
16384 | 14 | The browse dialog box can display shareable resources on remote systems. This is intended for applications that want to expose remote shares on a local system. Bit 6 must also be set.