ChooseFileName()

Summary

Gets the name of a new file using the Windows File Open dialog box.

Syntax

fnm = ChooseFileName(array file_types, string title, array options)

Returns

A string indicating the full path and filename (including file extension) of the chosen file.

Example

shared d_exts_table
on escape do Return(false) end
openfile:
fname = ChooseFileName(d_exts_table, "Save Table As", {{"Replace Warning", "False"}})
if FileCheckUsage({fname},) then do
ShowMessage("File already in use. Please choose again.")
goto openfile
end
on escape default

Notes

• If the suggested name option includes a valid path, this path will be used in preference to the path supplied by the initial directory option.

• If file_types is null, all types of files are listed in the dialog box.

• Even if there is only one file type description and specification, it must be a subarray within an array; for example file_types could be {{"Workspace", "*.wrkz"}}.

• A file type description can have more than one item in the specification, separated by semicolons, such as {{"Workspace, Dataview, Figure, Layout", "*.wrkz;*.dvw;*.fig;*.lay"}}

• The file type description will be shown in the Files of Type drop-down list in the File Open dialog box. To show the specification, add it to the file type description in parentheses. The description just labels the file type, while the specification is used to choose the files to display.

Example

on escape do return() end
 geo_file = ChooseFileName({ {"Compact (*.cdf)", "*.cdf"},
{"Standard (*.dbd)","*.dbd"}},
"Save As", )
 on escape default

Error Codes

See Also