setParent

移動先: 概要 戻り値 フラグ Python の例

概要

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

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

setParent は「元に戻す」が可能、「照会」が可能、「編集」が不可能です。

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

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

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

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
upLevel(u)	boolean
階層の 1 つ上のレベルに移動します。「..」を使用するのと同じです。
topLevel(top)	boolean
階層の最上位レベルに移動します。「/」を使用するのと同じです。
menu(m)	boolean
メニュー項目の親メニュー
defineTemplate(dt)	string
他の任意のフラグと引数を解析し、かつ指定した名前でコマンド テンプレートに追加するモードに、コマンドのモードを変更します。templateName がカレントのテンプレートとして設定されていれば、 その後コマンドが実行されるたびに、この引数がデフォルトの引数として使用されます。
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' )