Displays a standard Windows FileOpen or FileSave As dialog prompting the user to select a file.
0 |
Boolean |
File Open Dialog? (FALSE=Save As Dialog) |
TRUE displays a File Open dialog. FALSE specifies a File Save dialog. |
1 |
Directory Path |
Working Directory (Optional) |
The default location in the dialog when it is opened. |
2 |
String |
File Extension (Optional) |
Specify a file extension filter to apply to the dialog. |
3 |
String |
Dialog Title (Optional) |
The title to appear in the dialog’s title bar. |
4 |
Boolean |
File Selected (FALSE=Cancelled) |
Contains TRUE if a file was selected, or FALSE if the user closed the dialog box or clicked the CANCEL button. |
5 |
String |
File Name |
The selected file name only (without its path). |
6 |
String |
Path |
The selected path only (without the file name). |
7 |
String |
Path with File Name |
Both the path and file name. |
SUCCESS |
The command completed successfully. |
Argument 1 supports both absolute paths (ex. C:\test.xit) and relative paths (ex. .\test.xit). If a relative path is provided and the MP is embedded, the path will be relative to the current SA file location. If an argument is not provided at all, the default path will be the most recent save path used in SA.
Argument 2 should be a single file extension, without any other characters. For example, txt is a valid filter for .txt files.