Browse For File

Displays a standard Windows File†Open or File†Save As dialog prompting the user to select a file.

 

Input Arguments

 

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.

Return Arguments

 

 

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.

Returned Status

 

SUCCESS

The command completed successfully.

Remarks

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.