pymel.core.system.fileDialog

fileDialog(*args, **kwargs)

The fileBrowserDialog and fileDialog commands have now been deprecated. Both commands are still callable, but it is recommended that the fileDialog2 command be used instead. To maintain some backwards compatibility, both fileBrowserDialog and fileDialog will convert the flags/values passed to them into the appropriate flags/values that the fileDialog2 command uses and will call that command internally. It is not guaranteed that this compatibility will be able to be maintained in future versions so any new scripts that are written should use fileDialog2. See below for an example of how to change a script to use fileDialog2.

Flags:
Long name (short name) Argument Types Properties
application (app) bool ../../../_images/create.gif
 
This is a “Mac” only flag. This brings up the dialog which selects only the application bundle.
defaultFileName (dfn) unicode ../../../_images/create.gif
 
Set default file name. This flag is available under “write” mode
directoryMask (dm) unicode ../../../_images/create.gif
 

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.

mode (m) int ../../../_images/create.gif
 
Defines the mode in which to run the file dialog: 0 for read1 for writeWrite mode can not be used in conjunction with the -application flag.
title (t) unicode ../../../_images/create.gif
 

Set title text. The default value under “write” mode is “Save As”. The default value under “read” mode is “Open”.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.fileDialog

Example:

import pymel.core as pm

# Old way:
pm.fileDialog()
pm.fileDialog( directoryMask='/usr/u/bozo/myFiles/*.ma' )
pm.fileDialog( dm='*.cc' )

# Recommended way:
pm.fileDialog2(startingDirectory ="/usr/u/bozo/myFiles/", fileFilter="Maya Ascii (*.ma)")

Previous topic

pymel.core.system.fileBrowserDialog

Next topic

pymel.core.system.fileDialog2

Core

Core Modules

Other Modules

This Page