Function: choosedir( )

Syntax

choosedir {<title> {,<dir>}}

Type

string

Returns

Enables the operator to select a file directory (or folder in Windows-speak) via an interactive "Directory Select" window. When this function is invoked, a popup dialog window is displayed and the user can choose from a tree hierarchy of the local file system.

This function is currently available on Windows systems only.

Parameters

<title>
A string value providing a title for the selection dialog window. If this is omitted or an empty string value, the text Directory Selection will be used. Note that this directive may be disregarded on some systems.
<dir>
A string value providing an initial directory to act as a default. If omitted, the top of the file hierarchy will be used.

Notes

The value returned by this function is the name of the chosen directory. The directory is selected by pressing the ’OK’ or ’Select’ button in the popup window.

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

The position of the dialog window is determined by the value of menu_position.

No action is done to the selected folder/directory. This is the responsibility of the caller.

The system numeric identifier found is set by this function. It gets set to true on a successful directory selection, or false on dialog cancel or error.

Example

string fdir = choosedir('Indicate the source folder')