Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

fileDialog [-application] [-directoryMask string] [-mode string]

fileDialog is undoable, queryable, and editable.

Displays a file picking window, and returns the name of the file that the user picked. If the user picked no file, then an empty string is returned.

Return value

string

In query mode, return type is based on queried flag.

Related

fileBrowserDialog

Flags

application, directoryMask, mode
Long name (short name) argument types Properties
-mode(-m) string create
Defines the mode in which to run the file dialog:
  • 0 for read
  • 1 for write
Write mode can not be used in conjunction with the -application flag.
-directoryMask(-dm) string create
This can be used to specify what directory and file names will be displayed in the dialog. If not specified, the current directory will be used, with all files displayed. The string may contain a path name, and must contain a wild-carded file specifier. (eg "*.cc" or "/usr/u/*") If just a path is specified, then the last directory in the path is taken to be a file specifier, and this will not produce the desired results.
-application(-app) create
This is a "Mac" only flag. This brings up the dialog which selects only the application bundle.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command

MEL examples

fileDialog;
  fileDialog -directoryMask "/usr/u/bozo/myFiles/*.ma";
  fileDialog -dm "*.cc";