pymel.core.windows.deleteUI¶
- deleteUI(*args, **kwargs)¶
This command deletes UI objects such as windows and controls. Deleting a layout or window will also delete all of its children. If a flag is used then all objects being deleted must be of the specified type. This command may not be edited or queried. NOTE: it is recommended that the type flags be used to disambiguate different kinds of objects with the same name.
Flags:
Long Name / Short Name Argument Types Properties collection / cl bool Object names for deletion are all radio or tool collections. control / ctl bool Object names for deletion are all controls. editor / ed bool Object names for deletion are all editors. layout / lay bool Object names for deletion are all layouts. menu / m bool Object names for deletion are all menus. menuItem / mi bool Object names for deletion are all menu items. panel / pnl bool Object names for deletion are all panels. panelConfig / pc bool Object names for deletion are panel configurations. radioMenuItemCollection / ric bool Object names for deletion are all radio menu item collections. toolContext / tc bool Object names for deletion are all tool contexts. uiTemplate / uit bool Object names for deletion are all UI templates. window / wnd bool Object names for deletion are all windows. Flag can have multiple arguments, passed either as a tuple or a list. Derived from mel command maya.cmds.deleteUI
Example:
import pymel.core as pm # Example 1. # # Create a simple window and then delete it and all of its children # with one 'deleteUI -window' command. # window = pm.window() pm.paneLayout() # Result: ui.PaneLayout('window1|paneLayout2') # pm.button() # Result: ui.Button('window1|paneLayout2|button15') # pm.showWindow( window ) pm.deleteUI( window, window=True ) # Result: u'' # # Example 2. # # Create a window with a number of buttons and delete a few of the # buttons with the 'deleteUI -control' command. # window = pm.window() pm.columnLayout() # Result: ui.ColumnLayout('window1|columnLayout25') # pm.button() # Result: ui.Button('window1|columnLayout25|button16') # pm.button() # Result: ui.Button('window1|columnLayout25|button17') # pm.button() # Result: ui.Button('window1|columnLayout25|button18') # b1 = pm.button() b2 = pm.button() b3 = pm.button() pm.showWindow( window ) pm.deleteUI( b1, b2, b3, control=True ) # Result: u'' #