winopenfile()

Opens a dialog window to get a file to be read on the front-end workstation.

Syntax

Important: This feature is deprecated, and may be removed in a future version.
winopenfile(
   dirname STRING,
   typename STRING,
   extlist STRING,
   caption STRING )
  RETURNS STRING
  1. dirname is the default path to be displayed in the dialog window.
  2. typename is the name of the file type to be displayed.
  3. extlist is a blank-separated list of file extensions defining the file type.
  4. caption is the label to be displayed.

Usage

This function opens a dialog window to let the user select a file path on the front end workstation file system, in order to open the file.

The function returns the file path on success.

The function returns NULL if a problem has occurred or if the user canceled the dialog.

Important: This function is provided for backward compatibility and its use is not recommended if running your programs with different front-ends. It must be called after the front-end connection was established.