NativeMenuItem

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeMenuItem 클래스는 메뉴의 단일 항목을 나타냅니다.

메뉴 항목은 명령, 하위 메뉴 또는 분리 기호 선이 될 수 있습니다.

명령 항목을 만들려면 NativeMenuItem 생성자를 호출하여 레이블에 문자열을 전달하고 isSeparator 매개 변수에 false를 전달합니다.
하위 메뉴를 만들려면 부모 메뉴에 명령 항목을 만들고 해당 항목의 submenu 속성에 하위 메뉴의 NativeMenu 객체를 지정합니다. 부모 NativeMenu 객체의 addSubmenu() 메서드를 호출하여 해당 항목을 만들고 submenu 속성을 동시에 설정할 수도 있습니다.
분리 기호를 만들려면 NativeMenuItem 생성자를 호출하여 레이블에 빈 문자열을 전달하고 isSeparator 매개 변수에 true를 전달합니다.

항목 또는 부모 메뉴의 select 이벤트를 수신하면 메뉴 명령이 선택될 때를 감지할 수 있습니다. 하위 메뉴나 분리 기호는 모두 select 이벤트를 전달하지 않습니다. preparing 이벤트를 수신하여 해당하는 키를 통해 메뉴 항목을 활성화하거나 표시해야 할 경우를 결정합니다.

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		checked : Boolean 이 메뉴 항목이 확인 표시를 나타내는지 여부를 제어합니다.	NativeMenuItem
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		data : Object 이 메뉴 항목과 연관된 임의의 데이터 객체입니다.	NativeMenuItem
		enabled : Boolean 이 메뉴 항목이 활성화되어 있는지 여부를 제어합니다.	NativeMenuItem
		isSeparator : Boolean [읽기 전용] 이 항목이 메뉴 분리 기호 선인지 여부를 보고합니다.	NativeMenuItem
		keyEquivalent : String 이 메뉴 항목에 해당하는 키입니다.	NativeMenuItem
		keyEquivalentModifiers : Array 키에 해당하는 수정자에 대한 키 코드의 배열입니다.	NativeMenuItem
		label : String 이 메뉴 항목의 표시 문자열입니다.	NativeMenuItem
		menu : NativeMenu [읽기 전용] 이 항목을 포함하는 메뉴입니다.	NativeMenuItem
		mnemonicIndex : int 메뉴 항목 레이블에 있는 니모닉 문자의 위치입니다.	NativeMenuItem
		name : String 이 메뉴 항목의 이름입니다.	NativeMenuItem
		submenu : NativeMenu 이 메뉴 항목과 연관된 하위 메뉴입니다.	NativeMenuItem

공용 메서드

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

상속되는 공용 메서드 표시

	메서드		정의 주체
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) 새 NativeMenuItem 객체를 만듭니다.	NativeMenuItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		clone():NativeMenuItem NativeMenuItem 객체의 복사본을 만듭니다.	NativeMenuItem
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String [재정의] NativeMenuItem 객체의 속성이 모두 포함된 문자열을 반환합니다.	NativeMenuItem
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
displaying	항목을 포함하는 메뉴가 표시되기 직전 이 NativeMenuItem 객체에 의해 전달됩니다.	NativeMenuItem
preparing	해당하는 키가 눌린 다음 포함된 메뉴가 표시되기 직전에 이 NativeMenuItem 객체에 의해 전달됩니다.	NativeMenuItem
select	사용자가 메뉴 항목을 선택할 때마다 전달됩니다.	NativeMenuItem

속성 세부 정보

checked

속성

checked:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목이 확인 표시를 나타내는지 여부를 제어합니다.

구현
public function get checked():Boolean
public function set checked(value:Boolean):void

data

속성

data:Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목과 연관된 임의의 데이터 객체입니다.

이 속성에는 아무 객체나 지정할 수 있습니다. 지정된 객체는 메뉴 시스템에 사용되지 않지만 이벤트 객체의 대상 속성을 통해 이벤트 처리 코드에 사용될 수 있습니다. 기본적으로 이 속성의 값은 null입니다.

구현
public function get data():Object
public function set data(value:Object):void

enabled

속성

enabled:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목이 활성화되어 있는지 여부를 제어합니다.

구현
public function get enabled():Boolean
public function set enabled(value:Boolean):void

isSeparator

속성

isSeparator:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 항목이 메뉴 분리 기호 선인지 여부를 보고합니다.

NativeMenuItem 생성자의 isSeparator 매개 변수를 true 설정하여 분리 기호 선을 만듭니다.

구현
public function get isSeparator():Boolean

keyEquivalent

속성

keyEquivalent:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목에 해당하는 키입니다.

keyEquivalent를 소문자로 설정하여 Shift 키 수정자가 없는 단축키를 지정합니다. 대문자로 설정하여 Shift 키 수정자가 있는 단축키를 지정합니다.

기본적으로 키에 해당하는 수정자(Windows 또는 Linux의 Ctrl 및 Mac OS X의 Command)는 키에 해당하는 것의 일부분으로 포함됩니다. 키에 해당하는 것이 수정자가 없는 키가 되게 하려면 keyEquivalentModifiers 속성을 빈 배열로 설정합니다.

구현
public function get keyEquivalent():String
public function set keyEquivalent(value:String):void

keyEquivalentModifiers

속성

keyEquivalentModifiers:Array

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

키에 해당하는 수정자에 대한 키 코드의 배열입니다.

Keyboard 클래스에 정의된 상수를 사용하여 수정자 키 코드를 지정할 수 있습니다. 유효한 수정자 키는 다음과 같습니다.

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.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

관련 API 요소

flash.ui.Keyboard

label

속성

label:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목의 표시 문자열입니다.

구현
public function get label():String
public function set label(value:String):void

mnemonicIndex

속성

mnemonicIndex:int

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

메뉴 항목 레이블에 있는 니모닉 문자의 위치입니다.

지정된 위치의 문자는 메뉴 항목을 위한 니모닉 문자입니다. 인덱스는 0부터 시작하므로 첫 번째 문자에는 인덱스 0이 있습니다.

이 속성은 메뉴 니모닉을 사용하지 않는 운영 체제에서 무시됩니다.

구현
public function get mnemonicIndex():int
public function set mnemonicIndex(value:int):void

name

속성

name:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목의 이름입니다.

이름 값은 표시되지 않으며 로캘과 상관없는 식별자로 사용될 수 있습니다. 이름은 자동으로 지정되지 않습니다.

구현
public function get name():String
public function set name(value:String):void

submenu

속성

submenu:NativeMenu

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 메뉴 항목과 연관된 하위 메뉴입니다.

NativeMenu 객체를 이 속성에 지정하면 메뉴 항목의 모양과 비헤이비어가 변경됩니다. 하위 메뉴 항목은 하위 메뉴 아이콘을 표시하며 더 이상 select 이벤트를 전달하지 않습니다.

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

구현
public function get submenu():NativeMenu
public function set submenu(value:NativeMenu):void

관련 API 요소

flash.display.NativeMenu.addSubmenu()

생성자 세부 정보

()

생성자

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`로 설정합니다.

관련 API 요소

flash.display.NativeMenu.addSubmenu()

메서드 세부 정보

clone

()

메서드

public function clone():NativeMenuItem

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeMenuItem 객체의 복사본을 만듭니다.

반환값

NativeMenuItem

toString

()

메서드

override public function toString():String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeMenuItem 객체의 속성이 모두 포함된 문자열을 반환합니다.

반환값

String — Event 객체의 속성이 모두 포함된 문자열입니다.

이벤트 세부 정보

displaying

이벤트

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

항목을 포함하는 메뉴가 표시되기 직전 이 NativeMenuItem 객체에 의해 전달됩니다.

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

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

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

이 이벤트를 수신하여 포함된 메뉴가 표시되기 전이나 사용자가 해당 키를 누를 때 항목을 업데이트합니다. 해당 키가 완전히 평가되기 전에 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

사용자가 메뉴 항목을 선택할 때마다 전달됩니다.

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

참고: 메뉴가 포함된 윈도우가 전체 화면 모드인 경우(stage.displayState == StageDisplayState.FULL_SCREEN) 사용자가 메뉴 항목에 해당하는 키보드를 입력할 때 NativeMenuItem 객체가 select 이벤트를 전달하지 않습니다.

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

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

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

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

NativeMenuItem - AS3

클래스 x

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select