popupMenu command

概要

popupMenu [-allowOptionBoxes boolean] [-altModifier boolean] [-button int] [-ctrlModifier boolean] [-deleteAllItems] [-itemArray] [-markingMenu boolean] [-numberOfItems] [-postMenuCommand script] [-postMenuCommandOnce boolean] [-shiftModifier boolean] string

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

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

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

戻り値

string

メニューへのフルパス名

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

フラグ

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

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

-allowOptionBoxes(-aob) boolean

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

-altModifier(-alt) boolean

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

-button(-b) int

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

-ctrlModifier(-ctl) boolean

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

-deleteAllItems(-dai)

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

-itemArray(-ia)

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

-markingMenu(-mm) boolean

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

-numberOfItems(-ni)

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

-postMenuCommand(-pmc) script

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

-postMenuCommandOnce(-pmo) boolean

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

-shiftModifier(-sh) boolean

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

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

window;
columnLayout;
    button;
        popupMenu;
            menuItem; menuItem; menuItem;
    text;
        popupMenu -button 1;
            menuItem; menuItem; menuItem;
    checkBox aCheckBox;
        popupMenu -parent aCheckBox -alt true -ctl true;
            menuItem; menuItem; menuItem;
showWindow;

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