setParent

ジャンプ先: 概要. 戻り値. フラグ. Python 例.

概要

setParent( [string] , [defineTemplate=string], [menu=boolean], [topLevel=boolean], [upLevel=boolean], [useTemplate=string])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

setParent は、取り消し可能、照会可能、および編集不可能です。

コントロールは、コントロール レイアウトにペアレント化する必要があります。コントロール レイアウトは、別のコントロール レイアウトまたはウィンドウにペアレント化されることがあります。メニューは、ウィンドウまたはメニュー バー レイアウトにペアレント化されることがあります。このようなすべての場合において、setParent コマンド(フラグなし)は現在の既定の親を示します。

メニュー項目は、メニューにペアレント化する必要があります。既定のメニューの親を指定するには、コマンド setParent -m/menu を使用します。-sm/subMenu を使用して作成されるメニュー項目オブジェクトは、メニュー オブジェクトとして扱われる場合もあるので注意してください。

オブジェクトの作成時に明示的に -p/parent フラグを設定した場合、既定の親は無視されます。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ指定した名前でコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
menu(m)	boolean
メニュー項目の親メニュー
topLevel(top)	boolean
階層の最上位レベル レイアウトに移動します。「|」を使用するのと同じです。
upLevel(u)	boolean
階層の 1 つ上のレベルに移動します。「..」を使用するのと同じです。
useTemplate(ut)	string
強制的に、コマンドに現在以外の名前で指定したコマンド テンプレートを使用させます。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

#  Create a window with a menu bar and two menu bar layouts.
#
window = cmds.window(menuBar=True, widthHeight=(300, 200) )
fileMenu = cmds.menu( label='File')
cmds.menuItem( label='Open' )

cmds.paneLayout( configuration='vertical2' )

leftMenuBarLayout = cmds.menuBarLayout()
leftMenu = cmds.menu( label='Left' )
cmds.menuItem( label='One' )
cmds.setParent( '..' )

cmds.menuBarLayout()
cmds.menu( label='Right' )
rightSubMenu = cmds.menuItem(subMenu=True, label='Colors' )
cmds.setParent( '..' )
cmds.showWindow( window )

#  Add item to the "File" menu.
#
cmds.setParent( fileMenu, menu=True )
cmds.menuItem( label='Save' )

#  Add item to the "Left" menu, explicitly ignore default parent
#    by setting -p/parent flag.
#
cmds.menuItem( parent=leftMenu, label='Two' )

#  Add more items to the "File" menu because it is still the
#    default parent.
#
cmds.menuItem( divider=True )
cmds.menuItem( label='Close' )

#  Add another menu to the left menu bar layout.
#
cmds.setParent( leftMenuBarLayout )
cmds.menu( label='Middle' )
cmds.menuItem( label='Three' )

#  Add items to right sub menu.
#
cmds.setParent( rightSubMenu, menu=True )
cmds.menuItem( label='Red' )
cmds.menuItem( label='Blue' )
cmds.menuItem( label='Green' )