ChooseFile()

Summary

Gets the name of an existing file using the Windows File Open dialog box.

 

Syntax

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

 

Argument	Contents
file_types	An array of two-element arrays, with each subarray having a file type description (such as "Workspace") and a specification (such as "*.wrkz")
title	A title for the dialog box

 

Option	Type	Contents
Read Only	Boolean	If "True" the Read Only check box is displayed
Initial Directory	String	The directory first displayed by the dialog box
Help	String	A keyword in the help system; indicates the help topic displayed if the user presses F1

 

Returns

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

 

Notes

• 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.

• The directory name in the Initial Directory option must include a trailing backslash.

Example

geo_file = ChooseFile({

     {"Compact (*.cdf)", "*.cdf"},

     {"Standard (*.dbd)","*.dbd"}},

      "Choose a Geographic File", )

 

Error Codes

Error Type	Meaning
Escape	The user clicked Cancel or hit Escape
Error	File_types or one of the options is incorrectly specified

 

See Also

Function	Summary
ChooseDirectory()	Gets the path name to an existing directory/folder
ChooseFileName()	Gets the name of a new file using the Windows File Open dialog box
ChooseFiles()	Gets the names of one or more existing files using the Windows File Open dialog box
ChooseFolder()	Gets the path name to an existing directory/folder
FileCheckUsage()	Checks whether files are in use by Maptitude
GetFileInfo()	Gets information about a file.