Function: choosefile

Syntax

choosefile( {<mode> {,<file>}} )

Type

string

Returns

Enables the operator to select a file name via an interactive "File Select" window. When this function is invoked, a file selection popup window is displayed and the user can scan directories and choose a file.

Parameters

• <mode>
  When this has a zero value the window has the title "Open File Selection" and the activate button has the text "Open". IF omitted, zero is assumed. A value 1 has a title "Save File Selection" and "Save" on the activate button.

• <file>
  An indication of the start directory and a default file name for the selection if this parameter is a file then the file name part is used as the default file name, and the directory in which the file resides is used as the start directory. If this parameter is a directory then no default file name is used. If this parameter is omitted, the current directory is used for the start directory and no default file name is used.

Notes

The value returned by this function is the name of the chosen file, usually selected by pressing the ’Open" or ’Save" button in the popup window.

Pressing the 'Cancel' button will abort the operation and return an empty string.

No action is done to the selected file. This is the responsibility of the caller.