NativeMenu

패키지	flash.display
클래스	public class NativeMenu
상속	NativeMenu EventDispatcher Object
하위 클래스	ContextMenu

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeMenu 클래스에는 기본 메뉴를 정의할 수 있는 메서드 및 속성이 들어 있습니다.

AIR 프로파일 지원: 이 기능은 모든 데스크톱 운영 체제에서 지원되지만 휴대 장치나 AIR for TV 장치에서는 지원되지 않습니다. NativeMenu.isSupported 속성을 사용하여 런타임에 지원을 테스트할 수 있습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.

기본 메뉴는 응용 프로그램이 아닌 운영 체제에 의해 제어되고 표시되는 메뉴입니다. AIR에서는 다음과 같은 기본 메뉴 유형을 지원합니다.

응용 프로그램 메뉴는 OS X에서 지원됩니다. NativeApplication.supportsMenu 속성을 사용하여 호스트 운영 체제에서 응용 프로그램 메뉴가 지원되는지 여부를 테스트하십시오. 응용 프로그램 메뉴는 Mac 데스크톱 위쪽의 메뉴 모음에 표시됩니다. OS X는 모든 응용 프로그램에 대해 기본 메뉴를 제공하지만 많은 메뉴 명령이 작동하지 않습니다. 이벤트 리스너를 기본 항목에 추가하거나, 개별 메뉴 및 항목을 바꾸거나, 기본 메뉴 전체를 바꿀 수도 있습니다. NativeApplication menu 속성을 사용하여 응용 프로그램 메뉴 객체에 액세스합니다.
윈도우 메뉴는 Windows와 Linux에서 지원됩니다. NativeWindow.supportsMenu 속성을 사용하여 호스트 운영 체제에서 윈도우 메뉴가 지원되는지 여부를 테스트하십시오. 윈도우 메뉴는 윈도우 제목 표시줄 아래에 표시됩니다. 메뉴가 차지하는 영역은 윈도우 스테이지의 일부가 아닙니다. 응용 프로그램은 이 영역에 표시할 수 없습니다. NativeWindow menu 속성을 사용하여 윈도우에 메뉴를 지정합니다.
도크 아이콘 메뉴는 OS X에서 지원됩니다. NativeApplication.supportsDockIcon 속성을 사용하여 호스트 운영 체제에서 도크 아이콘이 지원되는지 여부를 테스트하십시오. 도크 아이콘 메뉴의 항목은 운영 체제에서 제공하는 기본 항목 위쪽에 표시됩니다. 기본 항목은 응용 프로그램 코드에서 액세스할 수 없습니다. 응용 프로그램의 DockIcon 객체의 menu 속성에 메뉴를 지정합니다.
시스템 트레이 아이콘 메뉴는 Windows 및 대부분의 Linux 운영 체제에서 지원됩니다. NativeApplication.supportsSystemTrayIcon 속성을 사용하여 호스트 운영 체제에서 시스템 트레이 아이콘이 지원되는지 여부를 테스트하십시오. 시스템 트레이 아이콘 메뉴는 컨텍스트 메뉴와 마찬가지로, 아이콘을 마우스 오른쪽 버튼으로 클릭할 때 표시됩니다. 응용 프로그램의 SystemTrayIcon 객체의 menu 속성에 메뉴를 지정합니다.
컨텍스트 메뉴는 모든 운영 체제에서 지원됩니다. 컨텍스트 메뉴는 응용 프로그램에 표시된 InteractiveObject를 마우스 오른쪽 버튼으로 클릭하거나 Command 키를 누른 상태에서 클릭할 때와 같이 사용자 인터페이스 이벤트가 발생할 때 표시됩니다. 메뉴를 표시하는 UI 메커니즘은 호스트 운영 체제 및 하드웨어에 따라 다릅니다. InteractiveObject의 contextMenu 속성에 메뉴를 지정합니다. AIR에서는 NativeMenu 클래스 또는 ContextMenu 클래스를 사용하여 컨텍스트 메뉴를 만들 수 있습니다. Flash Player에서는 ContextMenu 클래스만 사용할 수 있습니다. AIR의 ContextMenus에는 내장 항목이 없으므로 기본 컨텍스트 메뉴가 표시되지 않습니다.
팝업 메뉴는 모든 운영 체제에서 지원됩니다. 팝업 메뉴는 컨텍스트 메뉴와 작동 방식이 동일하지만 사용자 인터페이스 이벤트가 발생할 때 표시되지 않고 메뉴 display() 메서드를 사용하여 표시됩니다. 팝업 메뉴는 다른 객체에 연결되지 않습니다. 기본 메뉴를 만든 후 display() 메서드를 호출하기만 하면 됩니다.

메뉴 객체에는 메뉴 항목이 포함됩니다. 메뉴 항목은 명령, 하위 메뉴 또는 분리 기호 선을 나타낼 수 있습니다. addItem() 또는 addItemAt() 메서드를 사용하여 메뉴에 메뉴 항목을 추가합니다. 메뉴 항목의 표시 순서는 메뉴 items 배열에 있는 항목의 순서와 일치합니다.

하위 메뉴를 만들려면 부모 메뉴 객체에 메뉴 항목을 추가합니다. 부모 메뉴에서 일치하는 메뉴 항목의 submenu 속성에 하위 메뉴를 나타내는 메뉴 객체를 지정합니다.

참고: 윈도우의 루트 메뉴 및 응용 프로그램 메뉴에는 하위 메뉴 항목만 들어 있어야 합니다. 이러한 유형의 메뉴에 대한 사용자의 예상과는 달리 하위 메뉴를 나타내지 않는 항목은 표시되지 않을 수 있습니다.

메뉴의 명령 항목 또는 이 항목의 하위 메뉴 중 하나를 선택할 때 메뉴는 select 이벤트를 전달합니다. 하위 메뉴 및 분리 기호 항목은 선택할 수 없습니다. 이벤트 객체의 target 속성은 선택한 항목을 참조합니다.

메뉴 항목 중 하나에 해당하는 키가 눌리면 메뉴가 표시되기 직전에 메뉴가 preparing 이벤트를 전달합니다. 이 이벤트를 사용하면 응용 프로그램의 현재 상태를 기준으로 메뉴의 내용을 업데이트할 수 있습니다.

참고: Flex 프레임워크를 사용하는 경우에는 FlexNativeMenu 클래스를 사용하는 것을 고려합니다. ActionScript 코드를 작성하여 항목별로 메뉴 구조를 만드는 것보다 MXML에서 선언적으로 메뉴를 정의하는 것이 일반적으로 더 간편합니다.

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		isSupported : Boolean [정적] [읽기 전용] 클라이언트 시스템에서 기본 메뉴가 형태에 관계없이 지원되는지 여부를 나타냅니다.	NativeMenu
		items : Array 이 메뉴에 있는 NativeMenuItem 객체의 배열입니다.	NativeMenu
		numItems : int [읽기 전용] 이 메뉴에 있는 NativeMenuItem 객체의 수입니다.	NativeMenu
		parent : NativeMenu [읽기 전용] 부모 메뉴입니다.	NativeMenu

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		NativeMenu() 새 NativeMenu 객체를 만듭니다.	NativeMenu
		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
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	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
preparing	해당하는 키가 눌린 다음 메뉴가 표시되기 직전에 이 NativeMenu 객체에 의해 전달됩니다.	NativeMenu
select	해당 메뉴 항목 중 하나 또는 자손 하위 메뉴 중 하나에 있는 항목이 선택될 때 이 NativeMenu 객체에 의해 전달됩니다.	NativeMenu

속성 세부 정보

isSupported

속성

isSupported:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.0

클라이언트 시스템에서 기본 메뉴가 형태에 관계없이 지원되는지 여부를 나타냅니다.

구현
public static function get isSupported():Boolean

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

생성자 세부 정보

()

생성자

public function NativeMenu()

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

새 NativeMenu 객체를 만듭니다.

메서드 세부 정보

addItem

()

메서드

public function addItem(item:NativeMenuItem):NativeMenuItem

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

메뉴의 맨 아래에 메뉴 항목을 추가합니다.

컨텍스트 메뉴를 만들 때 NativeMenuItem 또는 ContextMenuItem 객체를 추가할 수 있습니다. 그러나 메뉴의 모든 항목이 같은 속성을 가지도록 컨텍스트 메뉴에서 하나의 객체 유형만 사용하는 것이 좋습니다.

참고: 항목의 하위 메뉴를 해당 메뉴 자체로 설정할 경우 순환 참조가 발생하여 항목을 메뉴에 추가할 때 응용 프로그램이 중지될 수 있습니다.

매개 변수

item:NativeMenuItem — 메뉴의 맨 아래에 추가할 NativeMenuItem 객체입니다.

반환값

NativeMenuItem

오류

	`ArgumentError` — `item`이 `null`인 경우입니다.

	`ArgumentError` — `item`이 다른 메뉴의 멤버인 경우입니다.

addItemAt

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

메뉴 항목을 지정된 위치에 삽입합니다. 위치는 위쪽부터 인덱싱됩니다. index 매개 변수를 0으로 설정하여 메뉴의 맨 위에 항목을 삽입합니다. 모든 메뉴 유형(윈도우, 응용 프로그램, 시스템 트레이 아이콘, 도크 아이콘, 컨텍스트 및 팝업)은 메뉴 위치를 위쪽부터 인덱싱합니다.

매개 변수

	`item:NativeMenuItem` — 삽입할 NativeMenuItem 객체입니다.

	`index:int` — 메뉴 항목을 삽입할 메뉴의 위치(0부터 시작)입니다. 참고: 항목의 하위 메뉴를 해당 메뉴 자체로 설정할 경우 순환 참조가 발생하여 항목을 메뉴에 추가할 때 응용 프로그램이 중지될 수 있습니다.

반환값

NativeMenuItem

오류

	`ArgumentError` — `item`이 `null`인 경우입니다.

	`ArgumentError` — `item`이 다른 메뉴의 멤버인 경우입니다.

	`RangeError` — 인덱스가 메뉴 `items` 배열의 경계를 벗어난 경우입니다.

addSubmenu

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

새 메뉴 항목을 삽입하여 메뉴에 하위 메뉴를 추가합니다.

addSubMenu() 메서드를 호출하는 것은 새 메뉴 항목을 만들고, 메뉴에 해당 항목을 추가하고, NativeMenu 객체를 항목의 submenu 속성에 지정하는 것과 같습니다.

참고: 순환 참조에서 한 메뉴를 해당 메뉴의 하위 메뉴로 추가하면 응용 프로그램이 중지될 수 있습니다.

매개 변수

	`submenu:NativeMenu` — 추가할 하위 메뉴를 정의하는 NativeMenu 객체입니다.

	`label:String` — 추가할 메뉴 항목용 표시 레이블입니다.

반환값

NativeMenuItem — 하위 메뉴용으로 만든 NativeMenuItem 객체입니다.

addSubmenuAt

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

지정된 위치에 새 메뉴 항목을 삽입하여 메뉴에 하위 메뉴를 추가합니다.

addSubMenuAt() 메서드를 호출하는 것은 새 메뉴 항목을 만들고, 메뉴에서 원하는 위치에 해당 항목을 삽입하고, NativeMenu 객체를 항목의 submenu 속성에 지정하는 것과 같습니다.

참고: 순환 참조에서 한 메뉴를 해당 메뉴의 하위 메뉴로 추가하면 응용 프로그램이 중지될 수 있습니다.

매개 변수

	`submenu:NativeMenu` — 추가할 하위 메뉴를 정의하는 NativeMenu 객체입니다.

	`index:int` — 추가할 메뉴 항목을 삽입할 이 메뉴의 `items` 배열에서의 위치입니다.

	`label:String` — 추가할 메뉴 항목용 표시 레이블입니다.

반환값

NativeMenuItem — 하위 메뉴용으로 만든 NativeMenuItem 객체입니다.

clone

()

메서드

public function clone():NativeMenu

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

메뉴의 복사본 및 모든 항목을 만듭니다.

반환값

NativeMenu

containsItem

()

메서드

public function containsItem(item:NativeMenuItem):Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴에 지정된 메뉴 항목이 포함되어 있는지 여부를 보고합니다.

매개 변수

item:NativeMenuItem — 조회할 NativeMenuItem 객체입니다.

반환값

Boolean — item이 이 메뉴에 있을 경우 true.

display

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

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부터 시작)이거나, 해당 항목이 이 메뉴에 없는 경우 -1입니다.

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

메뉴가 표시되기 직전에 이 NativeMenu 객체에서 전달됩니다.

메뉴가 표시되기 전에 이 이벤트를 수신하여 메뉴를 업데이트합니다. 메뉴의 항목도 displaying 이벤트를 전달합니다.

preparing 이벤트는 displaying 이벤트를 대체하고 추가 기능을 제공합니다. preparing 이벤트 또는 displaying 이벤트를 수신하지만 둘 다 수신하지는 않습니다.

참고: Mac OS X의 경우 AIR 2.6 이전에는 사용자가 해당 키를 누르면 메뉴 및 메뉴 항목이 displaying 이벤트를 전달했습니다. (다른 운영 체제에서는 해당 키 상호 작용에 대해 이 이벤트가 전달되지 않았습니다.) AIR 2.6부터는 사용자가 해당 키를 누를 때 displaying 이벤트가 더 이상 전달되지 않습니다. 대신 preparing 이벤트를 사용합니다.

Event.DISPLAYING 상수는 displaying 이벤트 객체의 type 속성 값을 정의합니다.

참고: 이 이벤트는 "캡처 단계"를 통과하지 않으며 대상이 표시 목록에 있는지 여부에 관계없이 대상으로 직접 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	표시될 객체입니다.

preparing

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.PREPARING

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.6

해당하는 키가 눌린 다음 메뉴가 표시되기 직전에 이 NativeMenu 객체에 의해 전달됩니다.

이 이벤트를 수신하여 메뉴가 표시되기 전 또는 사용자가 해당 키를 누를 때 메뉴를 업데이트합니다. 해당 키가 완전히 평가되기 전에 preparing 이벤트가 전달됩니다. preparing 이벤트 핸들러의 메뉴에서 항목을 활성화, 비활성화, 추가 또는 제거할 수 있고 이러한 변경 사항은 해당 키가 처리될 때 적용됩니다. 예를 들어 해당 키 트리거에 지정된 메뉴 항목을 제거하거나 비활성화하면 이벤트 시퀀스가 사실상 취소되고 select 이벤트가 전달되지 않습니다. 메뉴의 항목도 preparing 이벤트를 전달합니다.

Event.PREPARING 상수는 preparing 이벤트 객체의 type 속성 값을 정의합니다.

참고: 이 이벤트는 "캡처 단계"를 통과하지 않으며 대상이 표시 목록에 있는지 여부에 관계없이 대상으로 직접 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	이벤트를 전달한 객체입니다.
`target`	이벤트를 전달한 객체입니다.

select

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.SELECT

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

해당 메뉴 항목 중 하나 또는 자손 하위 메뉴 중 하나에 있는 항목이 선택될 때 이 NativeMenu 객체에 의해 전달됩니다.

select 이벤트는 메뉴 항목에서 포함된 메뉴로 버블링되고 부모 메뉴를 통해 루트 메뉴 객체에 체인으로 연결됩니다. 이벤트 객체의 target 속성은 선택한 NativeMenuItem 객체를 참조하고 currentTarget 속성은 NativeMenu 객체를 참조합니다.

Event.SELECT 상수는 select 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	항목이 선택된 객체입니다.

법적 고지 사항 | 온라인 개인 정보 보호 정책

NativeMenu - AS3

클래스 x

isSupported

items

numItems

parent

NativeMenu

addItem

addItemAt

addSubmenu

addSubmenuAt

clone

containsItem

display

getItemAt

getItemByName

getItemIndex

removeAllItems

removeItem

removeItemAt

setItemIndex

displaying

preparing

select