menu command

概要

menu( [string] , [allowOptionBoxes=boolean], [defineTemplate=string], [deleteAllItems=boolean], [docTag=string], [enable=boolean], [exists=boolean], [familyImage=string], [helpMenu=boolean], [itemArray=boolean], [label=string], [mnemonic=string], [numberOfItems=boolean], [parent=string], [postMenuCommand=script], [postMenuCommandOnce=boolean], [scrollable=boolean], [tearOff=boolean], [useTemplate=string], [version=string], [visible=boolean])

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

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

新しいメニューが作成され、親を指定していない場合は、既定のウィンドウのメニューバーに追加されます。メニューは有効、無効を切り替えることができます。コマンド menuItem -sm/subMenu true を使用して作成されたメニューオブジェクト上でもこのコマンドを使用できることに注意してください。

戻り値

string

メニューへのフルパス名

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

フラグ

allowOptionBoxes, defineTemplate, deleteAllItems, docTag, enable, exists, familyImage, helpMenu, itemArray, label, mnemonic, numberOfItems, parent, postMenuCommand, postMenuCommandOnce, scrollable, tearOff, useTemplate, version, visible

ロングネーム(ショートネーム) 引数タイプ プロパティ

allowOptionBoxes(aob) boolean

非推奨です。すべてのメニューは、オプションボックスを常に許可するようになりました。メニューがオプションウィンドウのメニュー項目をサポートできるかどうかを指定します。

defineTemplate(dt) string

他の任意のフラグと引数を解析し、かつ引数で指定したコマンドテンプレートに追加するモードに、コマンドのモードを変更します。 templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。

deleteAllItems(dai) boolean

このメニューにあるすべての項目を削除します。

docTag(dtg) string

メニューにタグがアタッチされます。

enable(en) boolean

メニューの有効、無効を切り替えます。

exists(ex) boolean

指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。

familyImage(fi) string

メニューに関連付けられたアイコンのファイル名。メニュー項目に定義されたアイコンイメージがない場合、このアイコンが使用されます。

helpMenu(hm) boolean

メニューをヘルプメニューに指定し、メニューバーの右端に配置します。UNIX システムでも、ヘルプメニューはメニューバーで右に寄せられます。

itemArray(ia) boolean

メニュー項目名の文字配列を返します。

label(l) string

メニューに表示されるテキスト。ラベルが提供されければ、menuName が使用されます。

mnemonic(mn) string

メニューの表示に Alt キーを割り当てます。指定する文字の大文字と小文字は、メニュー項目テキストの文字に合わせる必要がありますが、キーボードから選択する場合、大文字と小文字は区別されません。

numberOfItems(ni) boolean

メニューにあるオブジェクトの数を返します。

parent(p) string

メニューを表示するウィンドウを指定します。

postMenuCommand(pmc) script

メニューを表示するときに実行されるスクリプトを指定します。

postMenuCommandOnce(pmo) boolean

-pmc/postMenuCommand を一度だけ起動されるように指定します。既定値は false、つまりメニューが表示されるたびに -pmc/postMenuCommand が呼び出されます。

scrollable(srb) boolean

ポップアップメニューがスクロールをサポートするようにします。既定は false です。

tearOff(to) boolean

メニューを切り離せるようにします。

useTemplate(ut) string

コマンドに、現在のものとは異なるコマンドテンプレートを使用するように強制します。

version(ver) string

このメニュー機能が導入されたバージョンを指定します。引数は、バージョン番号の文字列として指定する必要があります(例: 「2014」、「2015」)。現時点では、メジャーバージョン番号のみが受け入れられます(例: 2014.5 は「2014」と指定する必要があります)。

visible(vis) boolean

メニューの表示/非表示を切り替えます。

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

Python 例

import maya.cmds as cmds

cmds.window( menuBar=True, width=200 )
cmds.menu( label='File', tearOff=True )
cmds.menuItem( label='New' )
cmds.menuItem( label='Open' )
cmds.menuItem( label='Save' )
cmds.menuItem( divider=True )
cmds.menuItem( label='Quit' )
cmds.menu( label='Help', helpMenu=True )
cmds.menuItem( 'Application..."', label='"About' )
cmds.columnLayout()
cmds.button()
cmds.button()
cmds.button()
cmds.showWindow()

コマンド (Python)	MEL バージョン
menu	カテゴリ内: ウィンドウ, メニュー