pymel.core.windows.panelConfiguration¶

panelConfiguration(*args, **kwargs)¶

This command creates a panel configuration object. Typically you would not call this method command directly. Instead use the Panel Editor. Once a panel configuration is created you can make it appear in the main Maya window by selecting it from any panel’s Panels-Saved Layoutsmenu.

Flags:

Long Name / Short Name		Argument Types	Properties
addPanel / ap		bool, unicode, unicode, unicode, unicode
	Adds the specified panel to the configuration. Arguments are: isFixed, label string, type string, create string, edit string.
configString / cfs		unicode
	Specifies the string that arranges the panels.
createStrings / cs		bool
	Returns an string array of the panel creation strings.
defaultImage / di		unicode
	The default image for this configuration. Once the default image is set it may not be changed. If an image is set with the -i/imageflag then it’s value will take precedence.
defineTemplate / dt		unicode
	Puts the command in a mode where any other flags and arguments are parsed and added to the command template specified in the argument. They will be used as default arguments in any subsequent invocations of the command when templateName is set as the current template.
editStrings / es		bool
	Returns an string array of the panel edit strings.
exists / ex		bool
	Returns whether the specified object exists or not. Other flags are ignored.
image / i		unicode
	The user specified image for this configuration. Use this flag to override the default image.
isFixedState / isFixedState		bool
	Returns an integer array of whether the panels have fixed states or not.
label / l		unicode
	Configuration label.
labelStrings / ls		bool
	Returns an string array of the panel labels.
numberOfPanels / np		bool
	Returns the number of panels in the configuration.
removeAllPanels / rap		bool
	Removes the last panel in the config.
removeLastPanel / rlp		bool
	Removes the last panel in the config.
replaceCreateString / rcs		int, unicode
	Replaces the specified create string. The index is 1 based.
replaceEditString / res		int, unicode
	Replaces the specified edit string. The index is 1 based.
replaceFixedState / rfs		int, bool
	Replaces the specified fixed state value (true|false). The index is 1 based.
replaceLabel / rl		int, unicode
	Replaces the specified label. The index is 1 based.
replacePanel / rp		int, bool, unicode, unicode, unicode, unicode
	Replaces the specified panel in the configuration. Arguments are: index, isFixed, label string, type string, create string, edit string. The index is 1 based.
replaceTypeString / rts		int, unicode
	Replaces the specified type string. The index is 1 based.
sceneConfig / sc		bool
	Specifies whether the configuration is associated with the scene. Scene configurations are created when the scene is opened and deleted when the scene is closed.
typeStrings / ts		bool
	Returns an string array of the panel types.
useTemplate / ut		unicode
	Forces the command to use a command template other than the current one.
userCreated / uc		bool
	Returns true if the configuration was created by the user. If it is user created, the configuration will show up in the RMB menu in the toolbox’s saved layouts. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.panelConfiguration

Example:

import pymel.core as pm

#    Create a custom panel configuration.
#
configName = pm.panelConfiguration(
                                label="Custom Panel Layout",
                                sceneConfig=False,
                                configString="paneLayout -e -cn \"vertical2\" -ps 1 39 100 -ps 2 61 100 $gMainPane;",
                                addPanel=[
                                        (False,
                                        'Outliner',
                                        'outlinerPanel',
                                        ("{global int $gUseMenusInPanels;\
                                        $panelName = `outlinerPanel -mbv $gUseMenusInPanels -unParent -l \"Outliner\"`;\
                                        outlinerEditor -e -highlightActive true $panelName;}"),
                                        "outlinerPanel -edit -l \"Outliner\"  $panelName"),

                                        (True,
                                        "Persp View",
                                        "modelPanel",
                                        ("{global int $gUseMenusInPanels;\
                                        modelPanel -mbv $gUseMenusInPanels\
                                        -unParent -l \"Persp View\" -cam persp;}" ),
                                        "modelPanel -edit -l \"Persp View\"  -cam \"persp\" $panelName")
                                ]
                        )

#    Update the main Maya window to reflect the custom panel configuration.
#    Note also that your custom configuration may be selected from any
#    panel's "Panels-"Saved Layouts" menu.
#
maya.mel.eval('setNamedPanelLayout( "Custom Panel Layout" )')