GetFilePath$ Function
Syntax
GetFilePath[$]([DefName$], [DefExt$], [DefDir$], _[Title$], [Option])
Group
Description
Put up a dialog and get a file path from the user. The returned string is a complete path and file name. If the cancel button is pressed then a null string is returned.
Sandbox
Sandbox mode blocks this function.
Parameters
Parameters | Description |
---|---|
DefName$ | Set the initial File Name in the to this string value. If this is omitted then *.DefExt$ is used. |
DefExt$ |
Initially show files whose extension matches this string value.
(Multiple extensions can be specified by using ";" as the separator.)
If this is omitted then * is used.
A "filter" may be specified using "description|*.ext|". Multiple descriptions can be used by repeating this format. (for example,. "Bitmap files|*.bmp|PNG files|*.png|JPEG files|*.jpg") |
DefDir$ | This string value is the initial directory. If this is omitted then the current directory is used. |
Title$ | This string value is the title of the dialog. If this is omitted then "Get File Path" is used. |
Option | This numeric value determines the file selection options. If this is omitted then zero is used. See table below. |
Option | Effect |
---|---|
0 | Only allow the user to select a file that exists. |
1 | Confirm creation when the user selects a file that does not exist. |
2 | Allow the user to select any file whether it exists or not. |
3 | Confirm overwrite when the user selects a file that exists. |
+4 | Selecting a different directory changes the application's current directory. |
Example
Sub Main Debug.Print GetFilePath$() End Sub