popupMenu

ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

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

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

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

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-allowOptionBoxes(-aob)	boolean
メニューがオプション ウィンドウのメニュー項目をサポートできるかどうかを指定します。オプションのフィールド項目をそれをサポートしていないメニューに追加すると、エラーになります。このフラグは照会が可能で、ポップアップ メニューの作成時に指定する必要があります。既定値は false です。
-altModifier(-alt)	boolean
ポップアップ メニューを表示する際に、Alt キーを押す必要があるときは、このフラグを指定します。
-button(-b)	int
ポップアップ メニューを表示するボタンを指定します。有効な値は 1～3 です。マウスの左ボタンは 1 となります。
-ctrlModifier(-ctl)	boolean
ポップアップ メニューを表示する際に Ctrl モディファイア キーを押す必要があるときは、このフラグを指定します。
-defineTemplate(-dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。 templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
-deleteAllItems(-dai)
このメニューにあるすべての項目を削除します。
-exists(-ex)
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
-itemArray(-ia)
メニュー項目名の文字配列を返します。
-markingMenu(-mm)	boolean
このポップアップ メニューのマーキング メニューの状態を設定します。
-numberOfItems(-ni)
メニューにあるオブジェクトの数を返します。
-parent(-p)	string
ポップアップ メニューを表示するコントロールを指定します。
-postMenuCommand(-pmc)	script
ポップアップ メニューが表示されるときに、実行されるスクリプトを指定します。
-postMenuCommandOnce(-pmo)	boolean
-pmc/postMenuCommand を一度だけ起動されるように指定します。既定値は false で、ポップアップ メニューが表示されるたびに -pmc/postMenuCommand が起動されます。
-shiftModifier(-sh)	boolean
ポップアップ メニューを表示する際に Shift モディファイア キーを押す必要があるときは、このフラグを指定します。
-useTemplate(-ut)	string
コマンドに、現在のものとは異なるコマンド テンプレートを使用するように強制します。

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

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;