OPENFILEDIALOG$: 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
(Correct return type) |
No edit summary |
||
Line 22: | Line 22: | ||
{{PageAvailability}} | {{PageAvailability}} | ||
* '''QB64-PE v3.4 and up''' | * '''QB64-PE v3.4.0 and up''' | ||
Revision as of 23:58, 10 January 2023
The _OPENFILEDIALOG$ function displays a standard dialog box that prompts the user to open a file. The returned string is an empty string ("") if the user cancelled. The returned string will contain file paths delimited using "|" if allowMultipleSelects& is passed as -1 (true) and multiple files are selected by the user.
Syntax
- result$ = _OPENFILEDIALOG$(title$, defaultPathAndFile$, filterPatterns$, singleFilterDescription$[, allowMultipleSelects&])
Parameters
- title$ is the dialog box title
- defaultPathAndFile$ is the default path that will be used by the dialog box if not changed by the user
- filterPatterns$ are the file filters separated using "|" (e.g., "*.png|*.jpg|*.gif")
- singleFilterDescription$ is the single filter description (e.g., "Image files")
- allowMultipleSelects& can be 0 (false) or -1 (true) if multiple file selection is to be allowed. If omitted, then this defaults to 0 (false)
Description
- All parameters accept an empty string ("") in which case system defaults are used
- If singleFilterDescription$ is an empty string (""), then filterPatterns$ will be shown in it's place
- The dialog box automatically becomes a modal window if the application window is visible
Availability
- QB64-PE v3.4.0 and up
Examples
- Example
- Simple open file dialog example
audiofiles$ = _OPENFILEDIALOG$("Open File", "", "*.mp3|*.ogg|*.wav|*.flac", "Audio files", -1) IF audiofiles$ <> "" THEN _MESSAGEBOX "Information", "You selected " + audiofiles$ |
See also
- _NOTIFYPOPUP
- _MESSAGEBOX
- _MESSAGEBOX (function)
- _INPUTBOX$
- _SELECTFOLDERDIALOG$
- _COLORCHOOSERDIALOG
- _SAVEFILEDIALOG$