| パッケージ | flash.ui |
| クラス | public final class ContextMenuItem |
| 継承 | ContextMenuItem NativeMenuItem EventDispatcher Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
customItems 配列にアイテムを追加します。
ContextMenuItem クラスのプロパティを使用して、特定のメニューアイテムを有効または無効にして、アイテムを表示または非表示にすることができます。
menuItemSelect イベントのイベントハンドラを記述して、ユーザーがメニューアイテムを選択したときにメニューアイテムに機能を追加します。
カスタムメニューアイテムは、コンテキストメニューの一番上、つまり、どのビルトインアイテムよりも上に表示されます。カスタムメニューアイテムとビルトインアイテムとの間には常にセパレータが表示されます。 (AIR では、ビルトインアイテムはありません)。
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
| caption : String
コンテキストメニューに表示するメニューアイテムのキャプション(テキスト)を指定します。 | ContextMenuItem | ||
![]() |
このメニューにチェックマークを表示するかどうかを制御します。 | NativeMenuItem | |
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
![]() |
このメニューアイテムに関連付けられた任意のデータオブジェクトです。 | NativeMenuItem | |
![]() |
このメニューを有効にするかどうかを制御します。 | NativeMenuItem | |
![]() | [読み取り専用]
このアイテムがメニューセパレータ線かどうかを報告します。 | NativeMenuItem | |
![]() |
このメニューアイテムのキーボードショートカットです。 | NativeMenuItem | |
![]() |
キーボードショートカットのモディファイアに対応するキーコードの配列です。 | NativeMenuItem | |
![]() |
このメニューアイテムの表示ストリングです。 | NativeMenuItem | |
![]() | [読み取り専用]
このアイテムを含むメニューです。 | NativeMenuItem | |
![]() |
メニューアイテムでのニーモニック文字の位置です。 | NativeMenuItem | |
![]() |
このメニューアイテムの名前です。 | NativeMenuItem | |
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
| separatorBefore : Boolean
指定されたメニューアイテムの上にセパレータを表示するかどうかを示します。 | ContextMenuItem | ||
![]() |
このメニューアイテムに関連付けられたサブメニューです。 | NativeMenuItem | |
| visible : Boolean
Flash Player のコンテキストメニューを表示するときに、指定されたメニューアイテムを表示するかどうかを示します。 | ContextMenuItem | ||
| メソッド | 定義元 | ||
|---|---|---|---|
ContextMenuItem(caption:String, separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true)
ContextMenu.customItems 配列に追加できる新しい ContextMenuItem オブジェクトを作成します。 | ContextMenuItem | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
[override]
NativeMenuItem オブジェクトのコピーを作成します。 | ContextMenuItem | ||
![]() |
イベントをイベントフローに送出します。 | EventDispatcher | |
![]() |
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
[静的] | ContextMenuItem | ||
[静的] | ContextMenuItem | ||
[静的] | ContextMenuItem | ||
[静的] | ContextMenuItem | ||
[静的] | ContextMenuItem | ||
[静的] | ContextMenuItem | ||
[静的] | ContextMenuItem | ||
![]() | [override]
NativeMenuItem オブジェクトのすべてのプロパティを含むストリングを返します。 | NativeMenuItem | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
![]() |
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
![]() | アイテムを含むメニューが表示される直前に、この NativeMenuItem から送出されます。 | NativeMenuItem | ||
| ユーザーがコンテキストメニューからアイテムを選択したときに送出されます。 | ContextMenuItem | |||
![]() | ユーザーがメニューアイテムを選択したときに送出されます。 | NativeMenuItem | ||
| caption | プロパティ |
caption:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
コンテキストメニューに表示するメニューアイテムのキャプション (テキスト) を指定します。caption 値の制約については、ContextMenuItem クラスの概要を参照してください。
public function get caption():String public function set caption(value:String):void| separatorBefore | プロパティ |
separatorBefore:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
指定されたメニューアイテムの上にセパレータを表示するかどうかを示します。
メモ : カスタムメニューアイテムとビルトインメニューアイテムの間には常にセパレータが表示されます。
デフォルト値 : false.
public function get separatorBefore():Boolean public function set separatorBefore(value:Boolean):void| visible | プロパティ |
visible:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 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 |
| ランタイムバージョン: | AIR 1.0 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 | () | メソッド |
| systemClearMenuItem | () | メソッド |
| systemCopyLinkMenuItem | () | メソッド |
| systemCopyMenuItem | () | メソッド |
| systemCutMenuItem | () | メソッド |
| systemOpenLinkMenuItem | () | メソッド |
| systemPasteMenuItem | () | メソッド |
| systemSelectAllMenuItem | () | メソッド |
| menuItemSelect | イベント |
flash.events.ContextMenuEventflash.events.ContextMenuEvent.MENU_ITEM_SELECT| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ユーザーがコンテキストメニューからアイテムを選択したときに送出されます。ユーザーは、ポインティングデバイスの第 2 ボタンをクリックすることにより、コンテキストメニューを生成します。
type プロパティ (menuItemSelect イベントオブジェクト) の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
contextMenuOwner | メニューが関連付けられている表示リストオブジェクトです。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
mouseTarget | ユーザーがコンテキストメニューを表示するために右クリックした表示リストオブジェクトです。 |
target | 選択された ContextMenuItem オブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
ContextMenuBuiltInItemsExample クラスを使用して、デフォルトのコンテキストメニューアイテムをステージから削除し、新しいメニューアイテムを追加します。これを行うには、以下の手順を実行します。
myContextMenu プロパティが宣言され、新しい ContextMenu オブジェクトに割り当てられます。removeDefaultItems() メソッドが呼び出されます。このメソッドによって、すべてのビルトインコンテキストメニューアイテムが削除されます。ただし、「プリント」を除きます。addCustomMenuItems() メソッドが呼び出され、Hello World というメニューアイテムを customItems 配列に配置します。このとき、配列の push() メソッドが使用されます。Hello World コンテキストメニューアイテムは、ステージのコンテキストメニューアイテム一覧に追加されます。
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/flex/3_jp/langref/flash/ui/ContextMenuItem.html