SELECTFOLDERDIALOG$: Difference between revisions
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
(Initial version) |
(Fix Description) |
||
Line 7: | Line 7: | ||
{{PageParameters}} | {{PageParameters}} | ||
* {{Parameter|title$}} is the dialog box | * {{Parameter|title$}} is a string that is displayed above the folder tree view in the dialog box | ||
* {{Parameter|defaultPath$}} is | * {{Parameter|defaultPath$}} is the default folder that is pre-selected (if the folder exists) | ||
{{PageDescription}} | {{PageDescription}} | ||
* All parameters accept an empty string ('''""''') in which case system defaults are used | * All parameters accept an empty string ('''""''') in which case system defaults are used | ||
* Use the | * Use the title$ to specify instructions to the user | ||
* The dialog box automatically becomes a modal window if the application window is visible | * The dialog box automatically becomes a modal window if the application window is visible | ||
* The folder selected must exist in the filesystem else an empty string is returned | * The folder selected must exist in the filesystem else an empty string is returned |
Revision as of 18:59, 29 October 2022
The _SELECTFOLDERDIALOG$ function displays a dialog box that enables the user to select a folder (directory). The returned string is a folder path or an empty string ("") if the user cancelled.
Syntax
- folder$ = _SELECTFOLDERDIALOG$(title$[, defaultPath$])
Parameters
- title$ is a string that is displayed above the folder tree view in the dialog box
- defaultPath$ is the default folder that is pre-selected (if the folder exists)
Description
- All parameters accept an empty string ("") in which case system defaults are used
- Use the title$ to specify instructions to the user
- The dialog box automatically becomes a modal window if the application window is visible
- The folder selected must exist in the filesystem else an empty string is returned
Availability
- QB64-PE v3.4 and up
Examples
- Example
- Folder selection
folder$ = _SELECTFOLDERDIALOG$("Select a folder to scan:") IF folder$ <> "" THEN _MESSAGEBOX "Information", "You selected " + folder$ |
See also