popupMenu コマンド

概要

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

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

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

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

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

戻り値

string

メニューのフルパス名。

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

フラグ

allowOptionBoxes, altModifier, button, ctrlModifier, deleteAllItems, itemArray, markingMenu, numberOfItems, postMenuCommand, postMenuCommandOnce, shiftModifier

ロングネーム（ショートネーム） 引数型 プロパティ

altModifier(alt) boolean

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

ctrlModifier(ctl) boolean

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

shiftModifier(sh) boolean

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

button(b) int

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

allowOptionBoxes(aob) boolean

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

markingMenu(mm) boolean

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

postMenuCommand(pmc) script

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

postMenuCommandOnce(pmo) boolean

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

numberOfItems(ni) boolean

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

itemArray(ia) boolean

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

deleteAllItems(dai) boolean

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

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

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	カテゴリ: ウィンドウ、メニュー