pymel.core.system.fileDialog2

static system.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
	If the dialogStyle flag is set to 2 then this provides a caption for the Cancel button within the dialog.
caption (cap)		unicode
	Provide a title for the dialog.
dialogStyle (ds)		int
	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
	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
	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)		callable
hideFileExtensions (hfe)		bool
okCaption (okc)		unicode
	If the dialogStyle flag is set to 2 then this provides a caption for the OK, or Accept, button within the dialog.
optionsUICommit (ocm)		callable
optionsUICreate (ocr)		callable
optionsUIInit (oin)		callable
returnFilter (rf)		bool
	If true, the selected filter will be returned as the last item in the string array along with the selected files. Flag can have multiple arguments, passed either as a tuple or a list.
selectFileFilter (sff)		unicode
	Specify the initial file filter to select. Specify just the begining text and not the full wildcard spec.
selectionChanged (sc)		callable
setProjectBtnEnabled (spe)		bool
startingDirectory (dir)		unicode
	Provide the starting directory for the dialog.

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)