pymel.core.windows.getPanel

getPanel(*args, **kwargs)

This command returns panel and panel configuration information.

Modifications:
  • returns a Panel object for flags: (containing or underPointer or withFocus)
  • returns a list of Panel objects for flags: not typeOf

Flags:

Long Name / Short Name Argument Types Properties
allConfigs / ac bool ../../../_images/create.gif
  Return the names of the all panel configuration in a string array.
allPanels / all bool ../../../_images/create.gif
  Return the names of all the panels in a string array.
allScriptedTypes / ast bool ../../../_images/create.gif
  Return the names of all types of scripted panels in a string array.
allTypes / at bool ../../../_images/create.gif
  Return the names of all types of panels, except scripted types in a string array.
atPosition / ap int, int ../../../_images/create.gif
  Return the name of the panel which contains the specified screen coordinates. An empty string is returned if there is no panel at those coordinates.
configWithLabel / cwl unicode ../../../_images/create.gif
  Return the name of the panel configuration with the specified label text.
containing / c unicode ../../../_images/create.gif
  Return the name of the panel containing the specified control. An empty string is returned if the specified control is not in any panel.
invisiblePanels / inv bool ../../../_images/create.gif
  Return the names of all the invisible panels in a string array.
scriptType / sty unicode ../../../_images/create.gif
  Return the names of all scripted panels of the specified type in a string array.
type / typ unicode ../../../_images/create.gif
  Return the names of all panels of the specified type in a string array.
typeOf / to unicode ../../../_images/create.gif
  Return the type of the specified panel.
underPointer / up bool ../../../_images/create.gif
  Return the name of the panel that the pointer is currently over. An empty string is returned if the pointer is not over any panel.
visiblePanels / vis bool ../../../_images/create.gif
  Return the names of all the visible panels in a string array.
withFocus / wf bool ../../../_images/create.gif
  Return the name of the panel that currently has focus. If no panel has focus then the last panel that had focus is returned.
withLabel / wl unicode ../../../_images/create.gif
  Return the name of the panel with the specified label text. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.getPanel

Example:

import pymel.core as pm

pm.getPanel( all=True )
# Result: [ui.Panel('modelPanel1'), ui.Panel('modelPanel2'), ui.Panel('modelPanel3'), ui.Panel('modelPanel4'), ui.Panel('outlinerPanel1'), ui.Panel('graphEditor1'), ui.Panel('dopeSheetPanel1'), ui.Panel('clipEditorPanel1'), ui.Panel('sequenceEditorPanel1'), ui.Panel('hyperGraphPanel1'), ui.Panel('hyperShadePanel1'), ui.Panel('visorPanel1'), ui.Panel('nodeEditorPanel1'), ui.Panel('createNodePanel1'), ui.Panel('polyTexturePlacementPanel1'), ui.Panel('renderView'), ui.Panel('blendShapePanel1'), ui.Panel('dynRelEdPanel1'), ui.Panel('relationshipPanel1'), ui.Panel('referenceEditorPanel1'), ui.Panel('componentEditorPanel1'), ui.Panel('dynPaintScriptedPanel'), ui.Panel('scriptEditorPanel1'), ui.Panel('StereoPanel')] #
pm.getPanel( type='modelPanel' )
# Result: [ui.Panel('modelPanel1'), ui.Panel('modelPanel2'), ui.Panel('modelPanel3'), ui.Panel('modelPanel4')] #
pm.getPanel( containing='button0' )
pm.getPanel( underPointer=True )
pm.getPanel( withFocus=True )
# Result: ui.Panel('modelPanel4') #

# Whenever the hotBox's 'noClickCommand' is invoked, have it switch the
# main Maya view to a single pane configuration, displaying the panel
# which was under the mouse pointer at the time the 'hotBox' command was
# executed.
def panePopAt(x, y):
        panel = pm.getPanel(atPosition=(x, y))
        if panel != '':
                mel.eval('doSwitchPanes(1, { "single", "' + panel + '" })')

pm.hotBox(noClickCommand=panePopAt, noClickPosition=True)