pymel.core.system.fileDialog2

fileDialog2(*args, **kwargs)

This command provides a dialog that allows users to select files or directories.

Flags:

Long Name / Short Name Argument Types Properties
cancelCaption / cc unicode ../../../_images/create.gif
  If the dialogStyle flag is set to 2 then this provides a caption for the Cancel button within the dialog.
caption / cap unicode ../../../_images/create.gif
  Provide a title for the dialog.
dialogStyle / ds int ../../../_images/create.gif
  1 On Windows or Mac OS X will use a native style file dialog.2 Use a custom file dialog with a style that is consistent across platforms.
fileFilter / ff unicode ../../../_images/create.gif
  Provide a list of file type filters to the dialog. Multiple filters should be separated by double semi-colons. See the examples section.
fileMode / fm int ../../../_images/create.gif
  Indicate what the dialog is to return. 0 Any file, whether it exists or not.1 A single existing file.2 The name of a directory. Both directories and files are displayed in the dialog.3 The name of a directory. Only directories are displayed in the dialog.4 Then names of one or more existing files.
fileTypeChanged / ftc unicode ../../../_images/create.gif
  MEL only. The string is interpreted as a MEL callback, to be called when the user-selected file type changes. The callback is of the form: global proc MyCustomFileTypeChanged(string $parent, string $newType) The parent argument is the parent layout into which controls have been added using the optionsUICreate flag. The newType argument is the new file type.
hideFileExtensions / hfe bool  
   
okCaption / okc unicode ../../../_images/create.gif
  If the dialogStyle flag is set to 2 then this provides a caption for the OK, or Accept, button within the dialog.
optionsUICancel / oca unicode ../../../_images/create.gif
  MEL only. The string is interpreted as a MEL callback, to be called when the dialog is cancelled (with Cancel button or close button to close window). The callback is of the form: global proc MyCustomOptionsUICancel()
optionsUICommit / ocm unicode ../../../_images/create.gif
  MEL only. The string is interpreted as a MEL callback, to be called when the dialog is successfully dismissed. It will not be called if the user cancels the dialog, or closes the window using window title bar controls or other window system means. The callback is of the form: global proc MyCustomOptionsUICommit(string $parent) The parent argument is the parent layout into which controls have been added using the optionsUICreate flag.
optionsUICommit2 / oc2 unicode ../../../_images/create.gif
  MEL only. As optionsUICommit, the given string is interpreted as a MEL callback, to be called when the dialog is successfully dismissed. The difference is that this callback takes one additional argument which is the file name selected by the user before the dialog validation. It will not be called if the user cancels the dialog, or closes the window using window title bar controls or other window system means. The callback is of the form: global proc MyCustomOptionsUICommit(string $parent, string $selectedFile) The parent argument is the parent layout into which controls have been added using the optionsUICreate flag.
optionsUICreate / ocr bool ../../../_images/create.gif
  MEL only. The string is interpreted as a MEL callback, to be called on creation of the file dialog. The callback is of the form: global proc MyCustomOptionsUISetup(string $parent) The parent argument is the parent layout into which controls can be added. This parent is the right-hand pane of the file dialog.
optionsUIInit / oin unicode ../../../_images/create.gif
  MEL only. The string is interpreted as a MEL callback, to be called just after file dialog creation, to initialize controls. The callback is of the form: global proc MyCustomOptionsUIInitValues(string $parent, string $filterType) The parent argument is the parent layout into which controls have been added using the optionsUICreate flag. The filterType argument is the initial file filter.
returnFilter / rf bool ../../../_images/create.gif
  If true, the selected filter will be returned as the last item in the string array along with the selected files.
selectFileFilter / sff unicode ../../../_images/create.gif
  Specify the initial file filter to select. Specify just the begining text and not the full wildcard spec.
selectionChanged / sc unicode ../../../_images/create.gif
  MEL only. The string is interpreted as a MEL callback, to be called when the user changes the file selection in the file dialog. The callback is of the form: global proc MyCustomSelectionChanged(string $parent, string $selection) The parent argument is the parent layout into which controls have been added using the optionsUICreate flag. The selection argument is the full path to the newly-selected file.
setProjectBtnEnabled / spe bool  
   
startingDirectory / dir unicode ../../../_images/create.gif
  Provide the starting directory for the dialog. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.fileDialog2

Example:

import pymel.core as pm

import maya.cmds as cmds

basicFilter = "*.mb"
pm.fileDialog2(fileFilter=basicFilter, dialogStyle=2)

singleFilter = "All Files (*.*)"
pm.fileDialog2(fileFilter=singleFilter, dialogStyle=2)

multipleFilters = "Maya Files (*.ma *.mb);;Maya ASCII (*.ma);;Maya Binary (*.mb);;All Files (*.*)"
pm.fileDialog2(fileFilter=multipleFilters, dialogStyle=2)