SELECTFOLDERDIALOG$: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:_SELECTFOLDERDIALOG$}}
{{DISPLAYTITLE:_SELECTFOLDERDIALOG$}}
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.
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.


{{PageSyntax}}
{{PageSyntax}}

Revision as of 01:05, 29 January 2023

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.0 and up


Examples

Example
Folder selection
folder$ = _SELECTFOLDERDIALOG$("Select a folder to scan:")
IF folder$ <> "" THEN _MESSAGEBOX "Information", "You selected " + folder$


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link