menuItem

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

概要

menuItem( [string] , [allowOptionBoxes=boolean], [altModifier=boolean], [annotation=string], [boldFont=boolean], [checkBox=boolean], [collection=string], [command=script], [commandModifier=boolean], [ctrlModifier=boolean], [data=int], [divider=boolean], [docTag=string], [dragDoubleClickCommand=script], [dragMenuCommand=script], [echoCommand=boolean], [enable=boolean], [enableCommandRepeat=boolean], [familyImage=string], [image=string], [imageOverlayLabel=string], [insertAfter=string], [isCheckBox=boolean], [isOptionBox=boolean], [isRadioButton=boolean], [italicized=boolean], [keyEquivalent=string], [label=string], [mnemonic=string], [optionBox=boolean], [optionModifier=boolean], [parent=string], [postMenuCommand=script], [postMenuCommandOnce=boolean], [radialPosition=string], [radioButton=boolean], [shiftModifier=boolean], [subMenu=boolean], [tearOff=boolean])

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

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

戻り値

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

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
label(l)	string
項目に表示されるテキスト。
divider(d)	boolean
ディバイダのメニュー項目が作成されます。
checkBox(cb)	boolean
チェック ボックスのメニュー項目が作成されます。引数により、チェック ボックスの値が指定されます。
isCheckBox(icb)	boolean
項目がチェック ボックス項目である場合に true が返されます。
radioButton(rb)	boolean
ラジオ ボタンのメニュー項目が作成されます。引数により、ラジオ ボタン値が指定されます。
isRadioButton(irb)	boolean
項目がラジオ ボタン項目である場合に true が返されます。
optionBox(ob)	boolean
メニュー項目をオプション ボックスの項目に指定します。この項目は、前のメニュー項目の右側に表示されます。
isOptionBox(iob)	boolean
項目がオプション ボックスの項目である場合に true が返されます。
enable(en)	boolean
メニュー項目の有効、無効の状態です。無効になっているメニュー項目はグレー表示で反応しません。有効になっているメニュー項目は選択することができ、通常どおりに表示されます。
parent(p)	string
項目を表示するメニューを指定します。
insertAfter(ia)	string
どの項目の後に新規の項目を配置するかを指定します。このフラグが指定されない場合、項目はメニューの最後に追加されます。メニューの先頭項目の前に挿入するには、空の文字列 "" を使用します。 警告: このフラグは、切り離したメニューで問題の原因になります。切離しが有効になっているメニューでは、このフラグを使用しないでください。つまり、親メニューで -to/tearOff フラグを設定しないでください。
collection(cl)	string
ラジオ メニュー項目がコレクションに明示的に追加されます。
image(i)	string
メニュー項目に関連付けられたアイコンのファイル名。メニュー項目を含むメニューを menuEditor で編集する場合、menuEditor ではメニュー項目がこのアイコンで表されます。このアイコンは、メニュー項目を配置するとシェルフ上に表示されます。
imageOverlayLabel(iol)	string
メニュー項目に関連付けられたアイコンの上に重ねて表示する短いテキスト文字列（5 文字）を指定します。これは、アイコン イメージが明確に定義されていないためにファミリ アイコンを使用するメニュー項目を差別化するメカニズムです。アイコン イメージがメニュー項目用に定義されていない場合、イメージ オーバーレイ ラベルは使用しません。
familyImage(fi)	string
メニューに関連付けられたファミリ アイコンのファイル名を取得します。 -image フラグで指定されるアイコンがなければ、ファミリ アイコンがシェルフに使用されます。
mnemonic(mn)	string
項目をアクティブにするように Alt キーが設定されます。 指定する文字の大文字と小文字は、メニュー項目テキストの文字に合わせる必要がありますが、キーボードから選択する場合、大文字と小文字は区別されません。
allowOptionBoxes(aob)	boolean
サブメニュー項目の場合、このフラグは、オプション ボックスのメニュー項目をサブメニューでサポートするかどうかを指定します。オプションのフィールド項目をそれをサポートしていないメニューに追加すると、エラーになります。このフラグは照会でき、サブメニュー項目の作成時に指定する必要があります。このフラグは、サブメニュー以外の項目で無視されます。デフォルト値は false です。
subMenu(sm)	boolean
項目にサブメニューを含めるよう指定します。 setParent -menu が呼び出されるまで、この後のメニュー項目はサブメニューに追加されます。サブメニュー項目がメニュー オブジェクトを作成し、その結果、コマンド menu をサブメニュー項目上で使用できることに注意してください。
tearOff(to)	boolean
メニュー項目がサブ メニューである場合は、このフラグにより、サブ メニューの切り離しが可能になります。このフラグが、その他のメニュー項目タイプに影響しないことに注意してください。
annotation(ann)	string
このメニュー項目に文字列の値で注釈を付けます。
docTag(dtg)	string
メニュー項目にタグがアタッチされます。
data(da)	int
ユーザ定義データの断片がメニュー項目にアタッチされます。
radialPosition(rp)	string
メニューがマーキング メニューにある場合は、メニュー項目のラジアル位置。ラジアル位置は、「N」、「NW」、「W」、「SW」、「S」、「SE」、「E」、「NE」のように、方位の形式で指定します。
command(c)	script
項目を選択した場合に実行されるコマンドかスクリプトがアタッチされます。このコマンドは、メニュー項目が optionMenu コントロールにある場合には実行されないことに注意してください。
dragMenuCommand(dmc)	script
メニュー項目をシェルフに配置すると、対応するシェルフ オブジェクトがクリックされた際にこのコマンドが呼び出されます。
dragDoubleClickCommand(ddc)	script
メニュー項目をシェルフに配置すると、対応するシェルフ オブジェクトがダブル クリックされた際にこのコマンドが呼び出されます。
postMenuCommand(pmc)	script
サブメニューを表示したときに実行されるスクリプトを指定します。
postMenuCommandOnce(pmo)	boolean
-pmc/postMenuCommand を一度だけ起動されるように指定します。デフォルト値は false、つまりサブメニューが表示されるたびに、-pmc/postMenuCommand が呼び出されます。
keyEquivalent(ke)	string
アクセラレータ文字を指定します。この文字は、-alt/altModifier、-opt/optionModifier、-ctl/ctlModifier、-cmd/commandModifier、および -sh/shiftModifier で指定したモディファイア キーと組み合わせて完全なアクセラレータ シーケンスを形成し、これを入力するとメニュー項目を実行できるようになります。通常のメニュー項目、ラジオ メニュー項目、チェック ボックス メニュー項目のみにアクセラレータを含めることができることに注意してください。
altModifier(alt)	boolean
optionModifier(opt)	boolean
Alt（または option）モディファイアをアクセラレータ シーケンスの一部にする場合に指定します。
ctrlModifier(ctl)	boolean
Cntl モディファイアをアクセラレータ シーケンスの一部にする場合に指定します。
commandModifier(cmd)	boolean
コマンド モディファイアをアクセラレータ シーケンスの一部にする場合に指定します。これは、個別のコマンド キーを持つシステム上でのみ使用可能です。
shiftModifier(sh)	boolean
Shift モディファイアをアクセラレータ シーケンスの一部にする場合に指定します。
enableCommandRepeat(ecr)	boolean
コマンドをアタッチできるメニュー項目のみに影響します。true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグは、オプション ボックス項目を除くすべての項目でデフォルトで true になっています。
echoCommand(ec)	boolean
-c/command フラグでアタッチしたアクションが呼び出された場合に、コマンド出力領域にエコーするかどうかを指定します。このフラグはデフォルトで false になっており、-c/command フラグとともに指定する必要があります。
italicized(itl)	boolean
テキストを斜体にするときに指定します。マーキング メニューの実装を使用するメニューだけサポートされます。デフォルトは false です。
boldFont(bld)	boolean
テキストを太字にするときに指定します。マーキング メニューの実装を使用するメニューだけサポートされます。デフォルトは、Windows では false、その他のすべてのプラットフォームでは true です。

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

Python の例

import maya.cmds as cmds

cmds.window( menuBar=True, width=200 )
cmds.menu( label='Stuff', allowOptionBoxes=True )
cmds.menuItem( subMenu=True, label='Colors' )
cmds.menuItem( label='Blue' )
cmds.menuItem( label='Green' )
cmds.menuItem( label='Yellow' )
cmds.setParent( '..', menu=True )
cmds.menuItem( divider=True )
cmds.radioMenuItemCollection()
cmds.menuItem( label='Yes', radioButton=False )
cmds.menuItem( label='Maybe', radioButton=False )
cmds.menuItem( label='No', radioButton=True )
cmds.menuItem( divider=True )
cmds.menuItem( label='Top', checkBox=True )
cmds.menuItem( label='Middle', checkBox=False )
cmds.menuItem( label='Bottom', checkBox=True )
cmds.menuItem( divider=True )
cmds.menuItem( label='Option' )
cmds.menuItem( optionBox=True )
cmds.columnLayout()
cmds.button()
cmds.button()
cmds.button()
cmds.showWindow()