openFile

Displays a file dialog window to get a path to open a file on the local file system.

Syntax

ui.Interface.frontCall("standard", "openFile",
 [path,name,wildcards,caption],
 [result])

path - The default path.
name - The name to be displayed for the file type.
wildcards - A blank separated list of wildcards (for ex: "*.pdf" or "README* test*.txt")
caption - The caption to be displayed.
result - Holds the name of the selected file (or NULL if canceled).

Usage

When invoking the "openFile" front call, the front-end displays a file dialog window using the local file system, to let the end user enter a file path, to select an existing file.

If the user cancels the dialog, the front call returns NULL in the result variable.

Note: With the GWS-JS front-end, the path parameter is ignored, and wildcards can only be hold one type of file extension.