popupMenu command

概要

popupMenu( string , [allowOptionBoxes=boolean], [altModifier=boolean], [button=int], [ctrlModifier=boolean], [defineTemplate=string], [deleteAllItems=boolean], [exists=boolean], [itemArray=boolean], [markingMenu=boolean], [numberOfItems=boolean], [parent=string], [postMenuCommand=script], [postMenuCommandOnce=boolean], [shiftModifier=boolean], [useTemplate=string])

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

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

このコマンドはポップアップメニューを作成し、親が指定されていない場合は現在のコントロールにアタッチします。既定では、ポップアップメニューは右マウスボタンで表示されます。

ポップアップメニューは任意のコントロールに加えることができますが、マウスによっては、ポップアップメニューを表示させるのに、標準のメニューボタン(マウスの第 3 ボタン)しか使用できません。これは、マウスの第 3 ボタンのみをポップアップメニューに割り当てるという、一般的に認められている UI のガイドラインに沿ったものです。また、第 1 ボタンと第 2 ボタンをテキストまたは項目の選択といった、コンテキスト上の操作用に確保することが想定されているテキストフィールドなどのコントロールの、予期せぬ動作を防止するためです。

戻り値

string

メニューへのフルパス名

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

フラグ

allowOptionBoxes, altModifier, button, ctrlModifier, defineTemplate, deleteAllItems, exists, itemArray, markingMenu, numberOfItems, parent, postMenuCommand, postMenuCommandOnce, shiftModifier, useTemplate

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

allowOptionBoxes(aob) boolean

メニューがオプションウィンドウのメニュー項目をサポートできるかどうかを指定します。オプションのフィールド項目をそれをサポートしていないメニューに追加すると、エラーになります。このフラグは照会が可能で、ポップアップメニューの作成時に指定する必要があります。既定値は false です。

altModifier(alt) boolean

ポップアップメニューを表示する際に、Alt キーを押す必要があるときは、このフラグを指定します。

button(b) int

ポップアップメニューを表示するボタンを指定します。有効な値は 1～3 です。マウスの左ボタンは 1 となります。

ctrlModifier(ctl) boolean

ポップアップメニューを表示する際に Ctrl モディファイアキーを押す必要があるときは、このフラグを指定します。

defineTemplate(dt) string

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

deleteAllItems(dai) boolean

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

exists(ex) boolean

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

itemArray(ia) boolean

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

markingMenu(mm) boolean

このポップアップメニューのマーキングメニューの状態を設定します。

numberOfItems(ni) boolean

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

parent(p) string

ポップアップメニューを表示するコントロールを指定します。

postMenuCommand(pmc) script

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

postMenuCommandOnce(pmo) boolean

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

shiftModifier(sh) boolean

ポップアップメニューを表示する際に Shift モディファイアキーを押す必要があるときは、このフラグを指定します。

useTemplate(ut) string

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

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

Python 例

import maya.cmds as cmds

cmds.window()
cmds.columnLayout()
cmds.button()
cmds.popupMenu()
cmds.menuItem()
cmds.menuItem()
cmds.menuItem()
cmds.text()
cmds.popupMenu( button=1 )
cmds.menuItem()
cmds.menuItem()
cmds.menuItem()
cmds.checkBox( 'aCheckBox' )
cmds.popupMenu( parent='aCheckBox', alt=True, ctl=True )
cmds.menuItem()
cmds.menuItem()
cmds.menuItem()
cmds.showWindow()

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