menuSet

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

概要

menuSet( [object] , [addMenu=string], [allMenuSets=boolean], [currentMenuSet=string], [exists=string], [hotBoxVisible=boolean], [insertMenu=[string, uint]], [label=string], [menuArray=[string,...]], [moveMenu=[string, uint]], [moveMenuSet=[string, uint]], [numberOfMenuSets=boolean], [numberOfMenus=boolean], [permanent=boolean], [removeMenu=string], [removeMenuSet=string])

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

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

戻り値

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

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
exists(ex)	string
指定したメニュー セットが存在するかどうかを返します。この照会フラグは文字列の引数（つまり、menuSet -q -exists animationMenuSet;）をサポートします。 このフラグは照会モードでは値が必要になります。
label(l)	string
カレントのメニュー セットのラベルです。照会すると、このフラグは string を返します。
addMenu(am)	string
メニューをカレントのメニュー セットの最後にアペンドします。
insertMenu(im)	[string, uint]
メニューをカレントのメニュー セットの指定したインデックス内に挿入します。
moveMenu(mm)	[string, uint]
指定したメニューをカレントのメニュー セットから新しい位置に移動します。
removeMenu(rm)	string
指定したメニューをカレントのメニュー セットから削除します。
numberOfMenus(nm)	boolean
カレントのメニュー セットのメニュー数です。照会すると、このフラグは整数を返します。
menuArray(ma)	[string,...]
カレントのメニュー セットのメニュー名（文字列）の配列です。照会すると、このフラグは文字配列を返します。
currentMenuSet(cms)	string
すべての操作（アペンド、挿入、削除など）の作用対象となる、現在アクティブなメニュー セットです。照会すると、このフラグは string を返します。
moveMenuSet(mms)	[string, uint]
指定したメニュー セットを別のインデックスに移動します。
removeMenuSet(rms)	string
指定したメニュー セット オブジェクトをすべてのメニュー セットのリストから削除します。
numberOfMenuSets(nms)	boolean
メニュー セットの合計数です。照会すると、このフラグは整数を返します。
allMenuSets(ams)	boolean
使用中のすべてのメニュー セットのオブジェクト名の配列を返します。照会すると、このフラグは文字配列を返します。
hotBoxVisible(hbv)	boolean
このメニュー セットをメイン メニュー バーだけでなくホットボックスにも表示するかどうかを指定します。
permanent(p)	boolean
このメニュー セットを移動できるかどうかを指定します。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# creating a new menu set;
cmds.menuSet( 'newMenuSetObjName', label='newMenuSet Label' )

# using commands on a current menu set
# first find the menu set if you don't know the name of it
animMS = maya.mel.eval('findMenuSetFromLabel("Animation")')

# menu sets can be queried like normal commands
animMenus = cmds.menuSet(animMS, query=True, menuArray=True)

# but editing the set requires either setting the current menu set...
# (notice that the menu set comamnds following specify no specific menu set)
cmds.menuSet( currentMenuSet=animMS )
cmds.menuSet( removeMenu=animMenus[0] )
# : (other commands which pertain to the animation menu set)

# .. or temporarily setting the menu set to work on (does not affect current menu set)
# (notice that every command following specifies the specific set to apply operations to)
polyMS = maya.mel.eval('findMenuSetFromLabel("Polygons")')
polyMenus = cmds.menuSet(polyMS, query=True, menuArray=True)
cmds.menuSet( modelMS, removeMenu=polyMenus[0], insertMenu=(polyMenus[1], 0) )

# .. where the following commands still affect the animation menu set
animMenus = cmds.menuSet(query=True, menuArray=True)

# if you need to find a specific menu...
deformMenu = maya.mel.eval( ('findMenuFromMenuSet(\"' + animMS + '\", "Deform")') )

# moving a menu from one spot to another
# (ie. moving the Deform Menu to the front of the list)
cmds.menuSet( moveMenu=(deformMenu, 0) )