パッケージflash.ui
クラスpublic final class ContextMenuItem
継承ContextMenuItem Inheritance EventDispatcher Inheritance Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

Flash Player のコンテキストメニューに表示するカスタムメニューアイテムを作成するには、ContextMenuItem クラスを使用します。各 ContextMenuItem オブジェクトには、コンテキストメニューに表示されるキャプション (テキスト) を指定できます。コンテキストメニューに新しいアイテムを追加するには、ContextMenu オブジェクトの customItems 配列にアイテムを追加します。

ContextMenuItem クラスのプロパティを使用して特定のメニューアイテムを有効または無効にすると、アイテムを表示または非表示にすることができます。

menuItemSelect イベントのイベントハンドラを記述して、ユーザーがメニューアイテムを選択したときにメニューアイテムに機能を追加します。

カスタムメニューアイテムは、コンテキストメニューの一番上、つまり、どのビルトインアイテムよりも上に表示されます。カスタムメニューアイテムとビルトインアイテムとの間には常にセパレータが表示されます。

制約 :

メモ : 英語以外のシステムで実行される場合、キャプションストリングは英語の一覧およびローカライズされた一覧の両方と比較されます。

例を表示

関連項目

ContextMenu クラス
ContextMenuBuiltInItems クラス


パブリック プロパティ
 プロパティ定義元
  caption : String
コンテキストメニューに表示するメニューアイテムのキャプション (テキスト) を指定します。
ContextMenuItem
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  enabled : Boolean
指定されたメニューアイテムが有効か無効かを示します。
ContextMenuItem
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  separatorBefore : Boolean
指定されたメニューアイテムの上にセパレータを表示するかどうかを示します。
ContextMenuItem
  visible : Boolean
Flash Player のコンテキストメニューを表示するときに、指定されたメニューアイテムを表示するかどうかを示します。
ContextMenuItem
パブリック メソッド
 メソッド定義元
  
ContextMenuItem(caption:String, separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true)
ContextMenu.customItems 配列に追加できる新しい ContextMenuItem オブジェクトを作成します。
ContextMenuItem
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
指定された ContextMenuItem オブジェクトのコピーを作成して返します。
ContextMenuItem
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
   ユーザーがコンテキストメニューからアイテムを選択したときに送出されます。ContextMenuItem
プロパティの詳細
captionプロパティ
caption:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

コンテキストメニューに表示するメニューアイテムのキャプション (テキスト) を指定します。caption 値の制約については、ContextMenuItem クラスの概要を参照してください。


実装
    public function get caption():String
    public function set caption(value:String):void
enabledプロパティ 
enabled:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

指定されたメニューアイテムが有効か無効かを示します。

デフォルト値 : true.


実装
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
separatorBeforeプロパティ 
separatorBefore:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

指定されたメニューアイテムの上にセパレータを表示するかどうかを示します。

メモ : カスタムメニューアイテムとビルトインメニューアイテムの間には常にセパレータが表示されます。

デフォルト値 : false.


実装
    public function get separatorBefore():Boolean
    public function set separatorBefore(value:Boolean):void
visibleプロパティ 
visible:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

Flash Player のコンテキストメニューを表示するときに、指定されたメニューアイテムを表示するかどうかを示します。

デフォルト値 : true.


実装
    public function get visible():Boolean
    public function set visible(value:Boolean):void
コンストラクタの詳細
ContextMenuItem()コンストラクタ
public function ContextMenuItem(caption:String, separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true)

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

ContextMenu.customItems 配列に追加できる新しい ContextMenuItem オブジェクトを作成します。

パラメータ
caption:String — メニューアイテムに関連付けられるテキストを指定します。caption 値の制約については、ContextMenuItem クラスの概要を参照してください。
 
separatorBefore:Boolean (default = false) — コンテキストメニューのメニューアイテムの上にセパレータを表示するかどうかを指定します。デフォルト値は false です。
 
enabled:Boolean (default = true) — コンテキストメニューのメニューアイテムが有効か無効かを指定します。デフォルト値は true (有効) です。このパラメータはオプションです。
 
visible:Boolean (default = true) — メニューアイテムを表示するか非表示にするかを指定します。デフォルト値は true (表示) です。
メソッドの詳細
clone()メソッド
public function clone():ContextMenuItem

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

指定された ContextMenuItem オブジェクトのコピーを作成して返します。コピーには、元のオブジェクトのすべてのプロパティが含まれます。

戻り値
ContextMenuItem — 元のオブジェクトのすべてのプロパティを含む ContextMenuItem オブジェクトです。
イベントの詳細
menuItemSelect イベント
イベントオブジェクトの型: flash.events.ContextMenuEvent
ContextMenuEvent.type property = flash.events.ContextMenuEvent.MENU_ITEM_SELECT

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

ユーザーがコンテキストメニューからアイテムを選択したときに送出されます。ユーザーがポインティングデバイスの第 2 ボタンをクリックすると、コンテキストメニューが生成されます。

type プロパティ (menuItemSelect イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
contextMenuOwnerメニューが関連付けられる表示リストオブジェクトです。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
mouseTargetユーザーがコンテキストメニューを表示するために右クリックした表示リストオブジェクトです。
target選択された ContextMenuItem オブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。
例の使用法
ContextMenuItemExample.as

次の例では、ContextMenuBuiltInItemsExample クラスを使用して、デフォルトのコンテキストメニューアイテムをステージから削除し、新しいメニューアイテムを追加します。これを行うには、以下の手順を実行します。
  1. myContextMenu プロパティが宣言され、新しい ContextMenu オブジェクトに割り当てられます。
  2. removeDefaultItems() メソッドが呼び出されます。このメソッドによって、すべてのビルトインコンテキストメニューアイテムが削除されます。ただし、[プリント] を除きます。
  3. addCustomMenuItems() メソッドが呼び出され、Hello World というメニューアイテムを customItems 配列に配置します。このとき、配列の push() メソッドが使用されます。
  4. Hello World コンテキストメニューアイテムは、ステージのコンテキストメニューアイテム一覧に追加されます。
  5. テキスト「ここを右クリック」が指定された TextField オブジェクトがステージに追加されます。
package {
    import flash.ui.ContextMenu;
    import flash.ui.ContextMenuItem;
    import flash.ui.ContextMenuBuiltInItems;
    import flash.display.Sprite;
    import flash.text.TextField;

    public class ContextMenuItemExample extends Sprite {
        private var myContextMenu:ContextMenu;

        public function ContextMenuItemExample() {
            myContextMenu = new ContextMenu();
            removeDefaultItems();
            addCustomMenuItems();
            this.contextMenu = myContextMenu;
            addChild(createLabel());
        }

        private function removeDefaultItems():void {
            myContextMenu.hideBuiltInItems();

            var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems;
            defaultItems.print = true;
        }

        private function addCustomMenuItems():void {
            var item:ContextMenuItem = new ContextMenuItem("Hello World");
            myContextMenu.customItems.push(item);
        }
        
        private function createLabel():TextField {
            var txtField:TextField = new TextField();
            txtField.text = "Right Click Here";
            return txtField;
        }
    }
}




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/flash/ui/ContextMenuItem.html