(AIR만 해당)
패키지flash.display
클래스public class NativeMenuItem
상속NativeMenuItem Inheritance EventDispatcher Inheritance Object
하위 클래스 ContextMenuItem

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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

항목 또는 부모 메뉴의 select 이벤트를 수신하면 메뉴 명령이 선택될 때를 감지할 수 있습니다. 하위 메뉴나 분리 기호는 모두 select 이벤트를 전달하지 않습니다. displaying 이벤트를 수신하면 메뉴 항목이 표시되려고 할 때를 결정할 수 있습니다.

참고 사항

flash.display.NativeMenu
flash.display.NativeMenu.addSubmenu()


Public 속성
 속성다음에 의해 정의됨
  AIR-only checked : Boolean
이 메뉴 항목이 확인 표시를 나타내는지 여부를 제어합니다.
NativeMenuItem
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  AIR-only data : Object
이 메뉴 항목과 연관된 임의의 데이터 객체입니다.
NativeMenuItem
  AIR-only enabled : Boolean
이 메뉴 항목이 활성화되어 있는지 여부를 제어합니다.
NativeMenuItem
  AIR-only isSeparator : Boolean
[읽기 전용] 이 항목이 메뉴 분리 기호 선인지 여부를 보고합니다.
NativeMenuItem
  AIR-only keyEquivalent : String
이 메뉴 항목에 해당하는 키입니다.
NativeMenuItem
  AIR-only keyEquivalentModifiers : Array
키에 해당하는 수정자에 대한 키 코드의 배열입니다.
NativeMenuItem
  AIR-only label : String
이 메뉴 항목의 표시 문자열입니다.
NativeMenuItem
  AIR-only menu : NativeMenu
[읽기 전용] 이 항목을 포함하는 메뉴입니다.
NativeMenuItem
  AIR-only mnemonicIndex : int
메뉴 항목 레이블에 있는 니모닉 문자의 위치입니다.
NativeMenuItem
  AIR-only name : String
이 메뉴 항목의 이름입니다.
NativeMenuItem
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  AIR-only submenu : NativeMenu
이 메뉴 항목과 연관된 하위 메뉴입니다.
NativeMenuItem
Public 메서드
 메서드다음에 의해 정의됨
  
AIR-only NativeMenuItem(label:String = "", isSeparator:Boolean = false)
새 NativeMenuItem 객체를 만듭니다.
NativeMenuItem
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
  
NativeMenuItem 객체의 복사본을 만듭니다.
NativeMenuItem
 Inherited
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
 Inherited
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
  
NativeMenuItem 객체의 속성이 모두 포함된 문자열을 반환합니다.
NativeMenuItem
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
  항목을 포함하는 메뉴가 표시되기 직전 이 NativeMenuItem 객체에 의해 전달됩니다.NativeMenuItem
  사용자가 메뉴 항목을 선택할 때마다 전달됩니다.NativeMenuItem
속성 정보
AIR-only checked속성
checked:Boolean  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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



구현
    public function get checked():Boolean
    public function set checked(value:Boolean):void
AIR-only data속성 
data:Object  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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



구현
    public function get data():Object
    public function set data(value:Object):void
AIR-only enabled속성 
enabled:Boolean  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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



구현
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
AIR-only isSeparator속성 
isSeparator:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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



구현
    public function get isSeparator():Boolean
AIR-only 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
AIR-only keyEquivalentModifiers속성 
keyEquivalentModifiers:Array  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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

수정자를 지정하지 않으면 기본적으로 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

참고 사항

AIR-only label속성 
label:String  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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



구현
    public function get label():String
    public function set label(value:String):void
AIR-only menu속성 
menu:NativeMenu  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

이 항목을 포함하는 메뉴입니다.



구현
    public function get menu():NativeMenu
AIR-only mnemonicIndex속성 
mnemonicIndex:int  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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

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



구현
    public function get mnemonicIndex():int
    public function set mnemonicIndex(value:int):void
AIR-only name속성 
name:String  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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



구현
    public function get name():String
    public function set name(value:String):void
AIR-only submenu속성 
submenu:NativeMenu  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

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



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

참고 사항

생성자 정보
AIR-only NativeMenuItem()생성자
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

새 NativeMenuItem 객체를 만듭니다.

메뉴 명령을 만들려면 label 매개 변수를 표시 레이블을 포함하는 문자열로 설정하고 isSeparatorfalse로 설정합니다.

하위 메뉴 명령을 만들려면 명령 항목을 만든 다음 하위 메뉴의 NativeMenu 객체를 해당 항목의 submenu 속성에 지정합니다. 항목을 부모 메뉴에 추가합니다.

분리 기호를 만들려면 label 매개 변수를 빈 문자열로 설정하고 isSeparatortrue로 설정합니다.

NativeMenu addItem()removeItem() 메서드를 사용하는 메뉴에서 항목을 추가하고 제거합니다.

매개 변수
label:String (default = "") — 항목을 위한 표시 레이블 또는 분리 기호를 위한 빈 문자열입니다.
 
isSeparator:Boolean (default = false) — 분리 기호를 만들려면 true로 설정하고 그 밖의 경우에는 false로 설정합니다.

참고 사항

메서드 정보
AIR-only clone()메서드
public function clone():NativeMenuItem

런타임 버전: AIR 1.0

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

반환값
NativeMenuItem
AIR-only toString()메서드 
override public function toString():String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0

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

반환값
String — Event 객체의 속성이 모두 포함된 문자열입니다.
이벤트 정보
AIR-only displaying 이벤트
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.DISPLAYING

런타임 버전: AIR 1.0

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

이벤트 객체의 target 속성은 이 NativeMenuItem 객체를 포함하는 NativeMenu 객체를 참조하고, currentTarget 속성은 이 NativeMenuItem을 참조합니다.

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

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

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

속성
bubbles false
cancelable false
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target 표시될 객체입니다.
AIR-only select 이벤트  
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.SELECT

런타임 버전: AIR 1.0

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

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

참고: 메뉴가 포함된 윈도우가 전체 화면 모드일 경우 사용자가 메뉴 항목에 해당하는 키보드 입력을 할 때 NativeMenuItem 객체는 select 이벤트를 전달하지 않습니다. 그러나 NativeWindow 객체의 stage 속성에 의해 전달된 keyDown 이벤트를 수신할 수 있습니다.

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

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

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