flash.display.NativeMenu （Flex 3.2）

メニュー	インスタンス	機能テスト	サポートしている OS	デフォルトでの提供
アプリケーション	`NativeApplication.nativeApplication.menu`	`NativeApplication.supportsMenu`	Mac OS X	あり
ウィンドウ	`NativeWindow.menu`	`NativeWindow.supportsMenu`	Windows, Linux	なし
ドックアイコン	`NativeApplication.nativeApplication.icon.menu`	`NativeApplication.supportsDockIcon`	Mac OS X	あり
システムトレイアイコン	`NativeApplication.nativeApplication.icon.menu`	`NativeApplication.supportsSystemTrayIcon`	Windows, Linux	なし
コンテキスト	`InteractiveObject.contextMenu`	常にサポート	すべて	なし
ポップアップ	任意の NativeMenu インスタンス	常にサポート	すべて	なし

	プロパティ	定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		items : Array このメニューの NativeMenuItem オブジェクトの配列です。	NativeMenu
		numItems : int [読み取り専用] このメニューの NativeMenuItem オブジェクトの数です。	NativeMenu
		parent : NativeMenu [読み取り専用] 親メニューです。	NativeMenu
		prototype : Object [静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object

	メソッド	定義元
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		addItem(item:NativeMenuItem):NativeMenuItem メニューの下部に、メニューアイテムを追加します。	NativeMenu
		addItemAt(item:NativeMenuItem, index:int):NativeMenuItem 指定された位置に、メニューアイテムを挿入します。	NativeMenu
		addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem 新しいメニューアイテムを挿入して、メニューにサブメニューを追加します。	NativeMenu
		addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem 指定された位置に新しいメニューアイテムを挿入して、メニューにサブメニューを追加します。	NativeMenu
		clone():NativeMenu メニューおよびすべてのアイテムのコピーを作成します。	NativeMenu
		containsItem(item:NativeMenuItem):Boolean このメニューが、指定されたメニューアイテムを含むかどうかを報告します。	NativeMenu
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		display(stage:Stage, stageX:Number, stageY:Number):void このメニューを、指定された位置にポップアップ表示します。	NativeMenu
		getItemAt(index:int):NativeMenuItem 指定されたインデックス位置にあるメニューアイテムを取得します。	NativeMenu
		getItemByName(name:String):NativeMenuItem 指定された名前を持つメニューアイテムを取得します。	NativeMenu
		getItemIndex(item:NativeMenuItem):int 指定されたアイテムの位置を取得します。	NativeMenu
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeAllItems():void メニューからすべてのアイテムを削除します。	NativeMenu
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		removeItem(item:NativeMenuItem):NativeMenuItem 指定されたメニューアイテムを削除します。	NativeMenu
		removeItemAt(index:int):NativeMenuItem 指定されたインデックス位置にあるメニューアイテムを削除して返します。	NativeMenu
		setItemIndex(item:NativeMenuItem, index:int):void 指定された位置に、メニューアイテムを移動します。	NativeMenu
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
displaying	メニューが表示される直前に、この NativeMenu オブジェクトから送出されます。	NativeMenu
select	いずれかのメニューアイテム、またはその子孫のサブメニューのいずれかのアイテムが選択された場合に、この NativeMenu オブジェクトから送出されます。	NativeMenu

プロパティの詳細

items

プロパティ

items:Array

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

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

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

実装
public function get items():Array
public function set items(value:Array):void

numItems

プロパティ

numItems:int [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

実装
public function get numItems():int

parent

プロパティ

parent:NativeMenu [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

親メニューです。

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

実装
public function get parent():NativeMenu

メソッドの詳細

addItem

()

メソッド

public function addItem(item:NativeMenuItem):NativeMenuItem

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

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

パラメータ

item:NativeMenuItem — メニューの下部に追加する NativeMenuItem です。

戻り値

NativeMenuItem

例外

	`ArgumentError` — `item` が `null` の場合。

	`ArgumentError` — `item` が他のメニューのメンバである場合。

addItemAt

()

メソッド

public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

指定された位置に、メニューアイテムを挿入します。

パラメータ

	`item:NativeMenuItem` — 挿入する NativeMenuItem オブジェクトです。

	`index:int` — メニューアイテムを挿入する、0 から始まるメニューの位置です。

戻り値

NativeMenuItem

例外

	`ArgumentError` — `item` が `null` の場合。

	`ArgumentError` — `item` が他のメニューのメンバである場合。

	`RangeError` — index が、メニューの `items` 配列の境界外の場合。

addSubmenu

()

メソッド

public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem

ランタイムバージョン:

AIR 1.0

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

addSubMenu() メソッドを呼び出すことは、新しいメニューアイテムを作成し、メニューアイテムをメニューに追加し、アイテムの submenu プロパティに NativeMenu オブジェクトを割り当てることと同じです。

パラメータ

	`submenu:NativeMenu` — 追加するサブメニューを定義する NativeMenu オブジェクトです。

	`label:String` — 追加するメニューアイテムの表示ラベルです。

戻り値

NativeMenuItem — サブメニューとして作成された NativeMenuItem オブジェクトです。

addSubmenuAt

()

メソッド

public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem

ランタイムバージョン:

AIR 1.0

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

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

パラメータ

	`submenu:NativeMenu` — 追加するサブメニューを定義する NativeMenu オブジェクトです。

	`index:int` — 追加するメニューアイテムを挿入する、このメニューの `items` 配列の位置です。

	`label:String` — 追加するメニューアイテムの表示ラベルです。

戻り値

NativeMenuItem — サブメニューとして作成された NativeMenuItem オブジェクトです。

clone

()

メソッド

public function clone():NativeMenu

ランタイムバージョン:

AIR 1.0

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

戻り値

NativeMenu

containsItem

()

メソッド

public function containsItem(item:NativeMenuItem):Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

パラメータ

item:NativeMenuItem — 検索対象の NativeMenuItem オブジェクトです。

戻り値

Boolean — true（item がこのメニューに存在する場合）。

display

()

メソッド

public function display(stage:Stage, stageX:Number, stageY:Number):void

ランタイムバージョン:

AIR 1.0

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

パラメータ

	`stage:Stage` — このメニューが表示される Stage オブジェクトです。

	`stageX:Number` — このメニューが表示される stage の原点を基準にした水平方向のピクセル数です。

	`stageY:Number` — このメニューが表示される stage の原点を基準にした垂直方向のピクセル数です。

getItemAt

()

メソッド

public function getItemAt(index:int):NativeMenuItem

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

パラメータ

index:int — 0 から始まる、返すアイテムの位置です。

戻り値

NativeMenuItem — メニューの指定された位置にある NativeMenuItem オブジェクトです。

例外

RangeError — index が、メニューの items 配列の境界外の場合。

getItemByName

()

メソッド

public function getItemByName(name:String):NativeMenuItem

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

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

パラメータ

name:String — 検索対象のストリングです。

戻り値

NativeMenuItem — 指定された名前を持つ NativeMenuItem オブジェクト、または null (メニューにそのようなアイテムがない場合) です。

getItemIndex

()

メソッド

public function getItemIndex(item:NativeMenuItem):int

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

パラメータ

item:NativeMenuItem — 検索対象の NativeMenuItem オブジェクトです。

戻り値

int — 指定されたアイテムの 0 から始まるこのメニューでの位置、または null (アイテムがこのメニューに存在しない場合) です。

removeAllItems

()

メソッド

public function removeAllItems():void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

removeItem

()

メソッド

public function removeItem(item:NativeMenuItem):NativeMenuItem

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

パラメータ

item:NativeMenuItem — このメニューから削除する NativeMenuItem オブジェクトです。

戻り値

NativeMenuItem

例外

RangeError — item がこのメニューに存在しない場合。

removeItemAt

()

メソッド

public function removeItemAt(index:int):NativeMenuItem

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

パラメータ

index:int — 0 から始まる、削除するアイテムの位置です。

戻り値

NativeMenuItem — 削除された NativeMenuItem オブジェクトです。

例外

RangeError — index が、このメニューの items 配列の境界外の場合。

setItemIndex

()

メソッド

public function setItemIndex(item:NativeMenuItem, index:int):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

パラメータ

	`item:NativeMenuItem` — 移動する NativeMenuItem オブジェクトです。

	`index:int` — `item` の移動先となる、0 から始まるメニューの位置です。

例外

RangeError — index が、メニューの items 配列の境界外の場合。

イベントの詳細

displaying

イベント

イベントオブジェクトの型: flash.events.Event
プロパティ Event.type = flash.events.Event.DISPLAYING

ランタイムバージョン:

AIR 1.0

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

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

Event.DISPLAYING 定数は、type プロパティ（displaying イベントオブジェクト）の値を定義します。

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	表示されるオブジェクトです。

select

イベント

イベントオブジェクトの型: flash.events.Event
プロパティ Event.type = flash.events.Event.SELECT

ランタイムバージョン:

AIR 1.0

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

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

Event.SELECT 定数は、type プロパティ（select イベントオブジェクト）の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	アイテムが選択されたオブジェクトです。

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/display/NativeMenu.html

Adobe® Flex™ 3.2 リファレンスガイド This Help system only	すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
NativeMenu	プロパティ \| メソッド \| イベント

パッケージ	flash.display
クラス	public class NativeMenu
継承	NativeMenu EventDispatcher Object
サブクラス	ContextMenu