NativeMenu  - AS3

クライアントシステムでネイティブメニューの任意のフォームがサポートされているかどうかを示します。

関連する API エレメント

このメニューの NativeMenuItem の配列です。

配列は、表示順にソートされています。

注意：このプロパティは、AIR 1.0 では読み取り専用です。AIR 1.1 で、読み取り / 書き込み可能になりました。

このメニューの NativeMenuItem オブジェクトの数です。

親メニューです。

ルート（最上位）メニューオブジェクトの parent は、null になります。

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

メニューの下部に、メニューアイテムを追加します。

コンテキストメニューを作成する場合は、NativeMenuItem または ContextMenuItem オブジェクトのいずれかを追加できます。ただし、メニュー内のすべてのアイテムが同じプロパティを持つようにするため、コンテキストメニューでは 1 つの型のオブジェクトのみを使用することをお勧めします。

注意：アイテムのサブメニューがメニュー自体に設定されている場合、アイテムをメニューに追加すると、アプリケーションが異常停止することがあります（循環参照が発生）。

パラメーター

指定された位置に、メニューアイテムを挿入します。位置のインデックスは上方から割り当てられます。メニューの最上位にアイテムを挿入するには、index パラメーターをゼロに設定します。ウィンドウ、アプリケーション、システムトレイアイコン、ドックアイコン、コンテキスト、ポップアップなど、すべてのタイプのメニューで、インデックスは上方から割り当てられます。

パラメーター

新しいメニューアイテムを挿入して、メニューにサブメニューを追加します。

addSubMenu() メソッドを呼び出すと、新しいメニューアイテムを作成するのと同様の処理が実行されます。メニューアイテムをメニューに追加し、アイテムの submenu プロパティに NativeMenu オブジェクトを割り当てます。

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

パラメーター

指定された位置に新しいメニューアイテムを挿入して、メニューにサブメニューを追加します。

addSubMenuAt() メソッドを呼び出すと、新しいメニューアイテムを作成するのと同様の処理が実行されます。メニューの指定された位置にメニューアイテムを挿入し、アイテムの submenu プロパティに NativeMenu オブジェクトを割り当てます。

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

パラメーター

メニューおよびすべてのアイテムのコピーを作成します。

このメニューが、指定されたメニューアイテムを含むかどうかを報告します。

パラメーター

このメニューを、指定された位置にポップアップ表示します。

パラメーター

指定されたインデックス位置にあるメニューアイテムを取得します。

パラメーター

指定された名前を持つメニューアイテムを取得します。

注意：メニューアイテムの name プロパティは、デフォルトでは割り当てられていません。

パラメーター

指定されたアイテムの位置を取得します。

パラメーター

メニューからすべてのアイテムを削除します。

指定されたメニューアイテムを削除します。

パラメーター

指定されたインデックス位置にあるメニューアイテムを削除して返します。

パラメーター

指定された位置に、メニューアイテムを移動します。該当するアイテムがまだメニュー内にない場合、このメソッドを呼び出すとメニューにアイテムが追加されます。

パラメーター

メニューが表示される直前に、この NativeMenu オブジェクトから送出されます。

このイベントを受け取り、メニューが表示される前に更新します。displaying イベントは、メニュー内の他のアイテムからも送出されます。

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

注意：AIR 2.6 より前の Mac OS X では、ユーザーがショットカットキーを押すとメニューおよびメニューアイテムによって displaying イベントが送出されます（このイベントは、他のオペレーティングシステム上では、ショートカットキーのインタラクションによって送出されることはありませんでした）。AIR 2.6 では、ユーザーがショットカットキーを押しても、displaying イベントは送出されません。代わりに、preparing イベントを使用します。

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

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

ショートカットキーが押され、メニューが表示される直前に、NativeMenu オブジェクトから送出されます。

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

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

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

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

いずれかのメニューアイテム、またはその子孫のサブメニューのいずれかのアイテムが選択された場合に、この NativeMenu オブジェクトから送出されます。

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

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