| パッケージ | flash.display |
| クラス | public class NativeMenuItem |
| 継承 | NativeMenuItem EventDispatcher Object |
| サブクラス | ContextMenuItem |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
メニューアイテムは、コマンド、サブメニューまたはセパレータ線です。
false を isSeparator パラメータに設定します。submenu プロパティに、作成するサブメニューの NativeMenu オブジェクトを割り当てます。親オブジェクトである NativeMenu の addSubmenu() メソッドを呼び出して、アイテムを作成し、同時に submenu プロパティを設定することもできます。true を isSeparator パラメータに設定します。アイテムまたは親メニューの select イベントを受け取り、メニューコマンドが選択された時期を検出します。サブメニューとセパレータは、選択イベントを送出しません。displaying イベントを受け取り、メニューアイテムを表示する時期を決定します。
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
このメニューにチェックマークを表示するかどうかを制御します。 | NativeMenuItem | ||
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
このメニューアイテムに関連付けられた任意のデータオブジェクトです。 | NativeMenuItem | ||
このメニューを有効にするかどうかを制御します。 | NativeMenuItem | ||
[読み取り専用]
このアイテムがメニューセパレータ線かどうかを報告します。 | NativeMenuItem | ||
このメニューアイテムのキーボードショートカットです。 | NativeMenuItem | ||
キーボードショートカットのモディファイアに対応するキーコードの配列です。 | NativeMenuItem | ||
このメニューアイテムの表示ストリングです。 | NativeMenuItem | ||
[読み取り専用]
このアイテムを含むメニューです。 | NativeMenuItem | ||
メニューアイテムでのニーモニック文字の位置です。 | NativeMenuItem | ||
このメニューアイテムの名前です。 | NativeMenuItem | ||
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
このメニューアイテムに関連付けられたサブメニューです。 | NativeMenuItem | ||
| メソッド | 定義元 | ||
|---|---|---|---|
新しい NativeMenuItem オブジェクトを作成します。 | NativeMenuItem | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
NativeMenuItem オブジェクトのコピーを作成します。 | NativeMenuItem | ||
![]() |
イベントをイベントフローに送出します。 | EventDispatcher | |
![]() |
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
[override]
NativeMenuItem オブジェクトのすべてのプロパティを含むストリングを返します。 | NativeMenuItem | ||
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
![]() |
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
| アイテムを含むメニューが表示される直前に、この NativeMenuItem から送出されます。 | NativeMenuItem | |||
| ユーザーがメニューアイテムを選択したときに送出されます。 | NativeMenuItem | |||
| プロパティ |
checked:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューにチェックマークを表示するかどうかを制御します。
public function get checked():Boolean public function set checked(value:Boolean):void| プロパティ |
data:Object| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューアイテムに関連付けられた任意のデータオブジェクトです。
このプロパティには、任意のオブジェクトを割り当てられます。割り当てられたオブジェクトはメニューシステムでは使用されず、(イベントオブジェクトの target プロパティを通じて) イベント処理コードで使用できます。デフォルトでは、このプロパティの値は null です。
public function get data():Object public function set data(value:Object):void| プロパティ |
enabled:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューを有効にするかどうかを制御します。
public function get enabled():Boolean public function set enabled(value:Boolean):void| プロパティ |
isSeparator:Boolean [読み取り専用] | 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このアイテムがメニューセパレータ線かどうかを報告します。
NativeMenuItem コンストラクタの isSeparator パラメータを true に設定して、セパレータ線を作成します。
public function get isSeparator():Boolean| プロパティ |
keyEquivalent:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューアイテムのキーボードショートカットです。
Shift キーモディファイアを使用しないショートカットを割り当てるには、小文字を使用して keyEquivalent を設定します。Shift キーモディファイアを使用するショートカットを割り当てるには、大文字を使用して設定します。
デフォルトでは、キーボードショートカットのモディファイア(Windows または Linux では Ctrl、Mac OS X では Command)がキーボードショートカットの一部に含まれます。キーボードショートカットをモディファイアのないキーにする場合、keyEquivalentModifiers プロパティを空の配列に設定します。
public function get keyEquivalent():String public function set keyEquivalent(value:String):void| プロパティ |
keyEquivalentModifiers:Array| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
キーボードショートカットのモディファイアに対応するキーコードの配列です。
Keyboard クラスで定義されている定数を使用して、モディファイアキーコードを指定します。有効なモディファイアキーは次のとおりです。
Keyboard.ALTERNATEKeyboard.COMMANDKeyboard.CONTROLモディファイアを割り当てない場合、Windows または Linux では Keyboard.CONTROL キー、Mac OS X では Keyboard.COMMAND キーがデフォルトで割り当てられます。キー相当物にこれらのモディファイアが含まれないようにするには、このプロパティを空の配列に設定します。
keyEquivalent プロパティに大文字を割り当てた場合、自動的にモディファイアとして Shift キーが使用されます。keyEquivalentModifier を空の配列に設定しても、モディファイアとしての Shift キーは削除されません。
public function get keyEquivalentModifiers():Array public function set keyEquivalentModifiers(value:Array):void関連項目
| プロパティ |
label:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューアイテムの表示ストリングです。
public function get label():String public function set label(value:String):void| プロパティ |
menu:NativeMenu [読み取り専用] | 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このアイテムを含むメニューです。
public function get menu():NativeMenu| プロパティ |
mnemonicIndex:int| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
メニューアイテムでのニーモニック文字の位置です。
指定された位置の文字が、そのメニューアイテムのニーモニック文字になります。インデックスは 0 から始まるので、最初の文字は 0 のインデックスを持ちます。
このプロパティは、メニューニーモニックを使用しないオペレーティングシステムでは無視されます。
public function get mnemonicIndex():int public function set mnemonicIndex(value:int):void| プロパティ |
name:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューアイテムの名前です。
名前の値は表示されず、ロケールに依存しない識別子として使用できます。名前は自動的に割り当てられるわけではありません。
public function get name():String public function set name(value:String):void| プロパティ |
submenu:NativeMenu| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
このメニューアイテムに関連付けられたサブメニューです。
このプロパティに NativeMenu オブジェクトを割り当てると、メニューアイテムの外観と動作が変化します。サブメニューアイテムはサブメニューアイコンを表示し、select イベントを送出しなくなります。
public function get submenu():NativeMenu public function set submenu(value:NativeMenu):void関連項目
| () | コンストラクタ |
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
新しい NativeMenuItem オブジェクトを作成します。
メニューコマンドを作成するには、label パラメータを表示ラベルを含むストリングに設定し、isSeparator を false に設定します。
サブメニューコマンドを作成するには、コマンドアイテムを作成し、サブメニューの NativeMenu オブジェクトをこのアイテムの submenu プロパティに割り当てます。親メニューにアイテムを追加します。
セパレータを作成するには、label パラメータを空のストリングに設定し、isSeparator を true に設定します。
NativeMenu の addItem() メソッドおよび removeItem() メソッドを使用して、メニューにアイテムを追加したり、メニューからアイテムを削除したりします。
label:String (default = "") — アイテムの表示ラベルまたはセパレータの空のストリングです。
| |
isSeparator:Boolean (default = false) — セパレータを作成する場合は true に設定し、それ以外の場合は false に設定します。
|
関連項目
| () | メソッド |
public function clone():NativeMenuItem| ランタイムバージョン: | AIR 1.0 |
NativeMenuItem オブジェクトのコピーを作成します。
戻り値NativeMenuItem |
| () | メソッド |
override public function toString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
NativeMenuItem オブジェクトのすべてのプロパティを含むストリングを返します。
戻り値String — Event オブジェクトのすべてのプロパティを含むストリングです。
|
| イベント |
flash.events.Eventflash.events.Event.DISPLAYING| ランタイムバージョン: | AIR 1.0 |
アイテムを含むメニューが表示される直前に、この NativeMenuItem から送出されます。
イベントオブジェクトの target プロパティは、この NativeMenuItem オブジェクトを含む NativeMenu を参照します。この NativeMenuItem は、currentTarget プロパティが参照します。
Event.DISPLAYING 定数は、type プロパティ(displaying イベントオブジェクト)の値を定義します。
メモ : このイベントは "キャプチャ段階" を経由せず、ターゲットが表示リストにあるかどうかにかかわらず、ターゲットに直接送出されます。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | 表示されるオブジェクトです。 |
| イベント |
flash.events.Eventflash.events.Event.SELECT| ランタイムバージョン: | AIR 1.0 |
ユーザーがメニューアイテムを選択したときに送出されます。
select イベントは、このアイテムからアイテムに含まれているメニューまで、親メニューのチェーンをルートメニューオブジェクトに向かって上方にバブルします。イベントオブジェクトの target プロパティは、この NativeMenuItem オブジェクトを参照します。currentTarget プロパティは、送出するオブジェクト (この NativeMenuItem またはその上位の NativeMenu オブジェクト) を参照します。
メモ : メニューを含むウィンドウがフルスクリーンモードである場合、NativeMenuItem オブジェクトは、ユーザーがメニューアイテムに相当するキーボード操作を入力しても select イベントを送出しません。ただし、keyDown イベントが送出されるのを監視することができます。これは、NativeWindow オブジェクトのNativeWindow オブジェクトの stage プロパティを確認して行います。
Event.SELECT 定数は、type プロパティ(select イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | アイテムが選択されたオブジェクトです。 |
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/display/NativeMenuItem.html