ChooseDirectory(), ChooseFolder()
Summary
Gets the path name to an existing directory/folder.
Changes
In Version 6.0/2012, the Show New Folder Button and Show Edit Text options are ignored by Windows versions after XP.
Syntax
dnm = ChooseDirectory(string prompt, array options)
| Argument | Contents |
|---|---|
| prompt | A string that appears above the directory tree |
| Option | Type | Contents |
|---|---|---|
| Initial Directory | String | The directory first displayed by the dialog box |
| Show Edit Text | Boolean | "True" (the default) show edit text item where user can type in a folder name, "False" to hide the item |
| Show New Folder Button | Boolean | "True" (the default) show a Make new folder button, "False" to hide the button |
Returns
A string indicating the path name of the chosen directory/folder.
Notes
-
Can also be called as ChooseFolder().
-
The directory name in the Initial Directory option must include a trailing backslash.
-
To have the former ChooseDirectory() behavior, set the Show Edit Text and Show New Folder Button options to "False."
-
For Windows versions after XP, the Show New Folder Button and Show Edit Text options are no longer relevant and are ignored.
Example
folder_name = ChooseDirectory("Choose a Folder", )Error Codes
| Error Type | Meaning |
|---|---|
| Escape | The user clicked Cancel or hit Escape |
| Error | The option is incorrectly specified |
See Also
| Function | Summary |
|---|---|
| ChooseFile() | Gets the name of an existing file using the Windows File Open dialog box |
| ChooseFileName() | Gets the name of a new file using the Windows File Open dialog box |
| ChooseFiles() | Gets the names of one or more existing files using the Windows File Open dialog box |
| GetDirectoryInfo() | Gets a listing of the contents of a directory |