UI.FileWindow title:Str, wildcard:Str, [helpId:Str]

File selection.

Opens the "select a file" dialog and lets the user choose a file. The title argument specifies what to show in the window title, the wildcard is a wildcard which specifies the default filter. For example, to choose a log file, do

 UI.FileWindow "Choose Log File", "*.log"

The optional third argument specifies a help page to use, it defaults to the help page for the file window. See UI.Help for more information.

When the user hits "OK", this command returns the chosen file in UI.Result; when the user cancels, UI.Result is set to EMPTY.

The file dialog uses the variable UI.Directory to initialize and store the current directory.

In text mode, this command gives a simple, no-frills input line (UI.Input).

Version Differences: In PCC 1.x, the help Id is an integer. In PCC2, it is a string.

Since: PCC 1.0.15, PCC2 1.99.21

See also: Global Commands