NativeMenuItem  - AS3

このメニューにチェックマークを表示するかどうかを制御します。

このメニューアイテムに関連付けられた任意のデータオブジェクトです。

このプロパティには、任意のオブジェクトを割り当てられます。割り当てられたオブジェクトはメニューシステムでは使用されず、（イベントオブジェクトの target プロパティを通じて）イベント処理コードで使用できます。デフォルトでは、このプロパティの値は null です。

このメニューを有効にするかどうかを制御します。

このアイテムがメニューセパレーター線かどうかを報告します。

NativeMenuItem コンストラクターの isSeparator パラメーターを true に設定して、セパレーター線を作成します。

このメニューアイテムのキー相当物です。

小文字を使用して keyEquivalent を設定し、Shift キーモディファイアを使用しないショートカットを割り当てます。大文字を使用して設定し、Shift キーモディファイアを使用するショートカットを割り当てます。

デフォルトでは、キーボードショートカットのモディファイア（Windows または Linux では Ctrl、Mac OS X では Command）がキーボードショートカットの一部に含まれます。キー相当物をモディファイアのないキーにする場合、keyEquivalentModifiers プロパティを空の配列に設定します。

キー相当物のモディファイアに対応するキーコードの配列です。

Keyboard クラスで定義されている定数を使用して、モディファイアキーコードを指定します。有効なモディファイアキーは次のとおりです。

• Keyboard.ALTERNATE
• Keyboard.COMMAND
• Keyboard.CONTROL

モディファイアを割り当てない場合、Windows または Linux では Keyboard.CONTROL キー、Mac OS X では Keyboard.COMMAND キーがデフォルトで割り当てられます。キー相当物にこれらのモディファイアが含まれないようにするには、このプロパティを空の配列に設定します。

keyEquivalent プロパティに大文字を割り当てると、Shift キーがモディファイアとして自動的に使用されます。keyEquivalentModifier を空の配列に設定しても、モディファイアとしての Shift キーは除去されません。

関連する API エレメント

このメニューアイテムの表示ストリングです。

このアイテムを含むメニューです。

メニューアイテムでのニーモニック文字の位置です。

指定された位置の文字が、そのメニューアイテムのニーモニック文字です。インデックスは 0 から始まるので、最初の文字は 0 のインデックスを持ちます。

このプロパティは、メニューニーモニックを使用しないオペレーティングシステムでは無視されます。

このメニューアイテムの名前です。

名前の値は表示されず、ロケールに依存しない識別子として使用できます。名前は自動的には割り当てられません。

このメニューアイテムに関連付けられたサブメニューです。

このプロパティに NativeMenu オブジェクトを割り当てると、メニューアイテムの外観と動作が変化します。サブメニューアイテムにサブメニューアイコンが表示され、select イベントが送出されなくなります。

注意：メニューをそのメニューのサブメニューとして追加すると（循環参照）、アプリケーションが異常停止することがあります。

関連する API エレメント

新しい NativeMenuItem オブジェクトを作成します。

メニューコマンドを作成するには、label パラメーターを表示ラベルを含むストリングに設定し、isSeparator を false に設定します。

サブメニューコマンドを作成するには、コマンドアイテムを作成し、サブメニューの NativeMenu オブジェクトをこのアイテムの submenu プロパティに割り当てます。親メニューにアイテムを追加します。

セパレーターを作成するには、label パラメーターを空のストリングに設定し、isSeparator を true に設定します。

NativeMenu の addItem() メソッドおよび removeItem() メソッドを使用して、メニューにアイテムを追加したり、メニューからアイテムを削除したりします。

関連する API エレメント

NativeMenuItem オブジェクトのコピーを作成します。

NativeMenuItem オブジェクトのすべてのプロパティを含むストリングを返します。

アイテムを含むメニューが表示される直前に、この NativeMenuItem から送出されます。

preparing イベントは displaying イベントを置き換え、追加機能を提供します。preparing イベントと displaying のいずれかをリッスンしますが、双方をリッスンすることはできません。

注意：このイベントは "キャプチャ段階" を経由せず、ターゲットが表示リストにあるかどうかにかかわらず、ターゲットに直接送出されます。

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

ショートカットキーが押され、格納されているメニューアイテムが表示される直前に、この NativeMenuItem から送出されます。

格納されているメニューを表示する前、またはそのショートカットキーが押された際に、アイテムを更新するためにこのイベントをリッスンします。preparing イベントはショートカットキーが完全に評価される前に送出されます。preparing イベントハンドラー内のメニューは、有効化、無効化、または削除できます。これらの変更は、ショートカットキーの処理時に有効になります。例えば、このメニューアイテムを削除または無効化した場合、イベントのシーケンスは事実上キャンセルされ、select イベントは送出されません。preparing イベントは、メニュー内の他のアイテムからも送出されます。

preparing イベントは displaying イベントを置き換え、追加機能を提供します。preparing イベントと displaying のいずれかをリッスンしますが、双方をリッスンすることはできません。

注意：このイベントは "キャプチャ段階" を経由せず、ターゲットが表示リストにあるかどうかにかかわらず、ターゲットに直接送出されます。

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

ユーザーがメニューアイテムを選択したときに送出されます。

select イベントは、このアイテムからアイテムに含まれているメニューまで、親メニューのチェーンをルートメニューオブジェクトに向かって上方にバブルします。イベントオブジェクトの target プロパティは、この NativeMenuItem オブジェクトを参照します。currentTarget プロパティは、送出するオブジェクト（この NativeMenuItem オブジェクトまたはその上位の NativeMenu オブジェクト）を参照します。

注意：メニューを含むウィンドウがフルスクリーンモードである場合（stage.displayState == StageDisplayState.FULL_SCREEN）、NativeMenuItem オブジェクトは、ユーザーがメニューアイテムにキーボードショートカットを入力しても select イベントを送出しません。

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