ContextMenu コンストラクタ

public ContextMenu([callbackFunction: Function ])

新しい ContextMenu オブジェクトを作成します。オブジェクトを作成する際に、イベントハンドラの識別子を指定することもできます。指定した関数は、ユーザーがコンテキストメニューを表示したときに、メニューが実際に表示されるよりも前に呼び出されます。これは、アプリケーションの状態や、ユーザーが右クリック (Windows) または Control キーを押しながらクリック (Macintosh) したオブジェクトの種類 (ムービークリップ、テキストフィールド、ボタンなど) またはタイムラインに応じて、メニューの内容をカスタマイズする場合に便利です。イベントハンドラの作成例については、ContextMenu.onSelectを参照してください。

対応バージョン : ActionScript 1.0、Flash Player 7

パラメータ

callbackFunction:Function (オプション) - ユーザーが右クリック (Windows の場合) または Control キーを押したままクリック (Macintosh の場合) したときに、メニューが表示される前に呼び出される関数への参照。

例

次の例では、コンテキストメニュー内のすべてのビルトインオブジェクトを非表示にします。ただし、[設定] と [Macromedia Flash Player 7 について] は無効にできません。

var newMenu:ContextMenu = new ContextMenu();
newMenu.hideBuiltInItems();
this.menu = newMenu;

次の例では、指定されたイベントハンドラ menuHandler がブール型変数showItem の値に応じてカスタムメニューアイテム (ContextMenu.customItems 配列を使用) を有効または無効にします。この変数の値が false の場合は、カスタムメニューアイテムを無効にします。それ以外の場合は有効にします。

var showItem = true; // Change this to false to remove
var my_cm:ContextMenu = new ContextMenu(menuHandler);
my_cm.customItems.push(new ContextMenuItem("Hello", itemHandler));
function menuHandler(obj, menuObj) {
    if (showItem == false) {
    menuObj.customItems[0].enabled = false;
    } else {
    menuObj.customItems[0].enabled = true;
    }
}
function itemHandler(obj, item) {
    //...put code here...
    trace("selected!");
}
this.menu = my_cm;

ユーザーがステージ上で右クリック (Windows の場合) または Control キーを押したままクリック (Macintosh の場合) すると、カスタムメニューが表示されます。

ContextMenu コンストラクタ

パラメータ

例

関連項目