popupMenu コマンド

概要

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

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

-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)

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

-itemArray(-ia)

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

-deleteAllItems(-dai)

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

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