| 패키지 | flash.display |
| 클래스 | public class NativeMenuItem |
| 상속 | NativeMenuItem EventDispatcher Object |
| 하위 클래스 | ContextMenuItem |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
메뉴 항목은 명령, 하위 메뉴 또는 분리 기호 선이 될 수 있습니다.
isSeparator 매개 변수에 false를 전달합니다.
submenu 속성에 하위 메뉴의 NativeMenu 객체를 지정합니다. 부모 NativeMenu 객체의 addSubmenu() 메서드를 호출하여 해당 항목을 만들고 submenu 속성을 동시에 설정할 수도 있습니다.
isSeparator 매개 변수에 true를 전달합니다.
항목 또는 부모 메뉴의 select 이벤트를 수신하면 메뉴 명령이 선택될 때를 감지할 수 있습니다. 하위 메뉴나 분리 기호는 모두 select 이벤트를 전달하지 않습니다. displaying 이벤트를 수신하면 메뉴 항목이 표시되려고 할 때를 결정할 수 있습니다.
참고 사항
| 속성 | 다음에 의해 정의됨 | ||
|---|---|---|---|
이 메뉴 항목이 확인 표시를 나타내는지 여부를 제어합니다. | NativeMenuItem | ||
![]() | constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
이 메뉴 항목과 연관된 임의의 데이터 객체입니다. | NativeMenuItem | ||
이 메뉴 항목이 활성화되어 있는지 여부를 제어합니다. | NativeMenuItem | ||
[읽기 전용] 이 항목이 메뉴 분리 기호 선인지 여부를 보고합니다. | NativeMenuItem | ||
이 메뉴 항목에 해당하는 키입니다. | NativeMenuItem | ||
키에 해당하는 수정자에 대한 키 코드의 배열입니다. | NativeMenuItem | ||
이 메뉴 항목의 표시 문자열입니다. | NativeMenuItem | ||
[읽기 전용] 이 항목을 포함하는 메뉴입니다. | NativeMenuItem | ||
메뉴 항목 레이블에 있는 니모닉 문자의 위치입니다. | NativeMenuItem | ||
이 메뉴 항목의 이름입니다. | NativeMenuItem | ||
![]() | prototype : Object [정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다. | Object | |
이 메뉴 항목과 연관된 하위 메뉴입니다. | NativeMenuItem | ||
| 메서드 | 다음에 의해 정의됨 | ||
|---|---|---|---|
새 NativeMenuItem 객체를 만듭니다. | NativeMenuItem | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
NativeMenuItem 객체의 복사본을 만듭니다. | NativeMenuItem | ||
![]() | 이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
![]() | EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
![]() | 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
![]() | Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
![]() | 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
![]() | EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
![]() | 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
NativeMenuItem 객체의 속성이 모두 포함된 문자열을 반환합니다. | NativeMenuItem | ||
![]() | 지정된 객체의 프리미티브 값을 반환합니다. | Object | |
![]() | 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
| 이벤트 | 요약 | 다음에 의해 정의됨 | ||
|---|---|---|---|---|
![]() | [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | ||
![]() | [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | ||
| 항목을 포함하는 메뉴가 표시되기 직전 이 NativeMenuItem 객체에 의해 전달됩니다. | NativeMenuItem | |||
| 사용자가 메뉴 항목을 선택할 때마다 전달됩니다. | NativeMenuItem | |||
| 속성 |
checked:Boolean [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 메뉴 항목이 확인 표시를 나타내는지 여부를 제어합니다.
public function get checked():Boolean public function set checked(value:Boolean):void| 속성 |
data:Object [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 메뉴 항목과 연관된 임의의 데이터 객체입니다.
이 속성에는 아무 객체나 지정할 수 있습니다. 지정된 객체는 메뉴 시스템에 사용되지 않지만 이벤트 객체의 대상 속성을 통해 이벤트 처리 코드에 사용될 수 있습니다. 기본적으로 이 속성의 값은 null입니다.
public function get data():Object public function set data(value:Object):void| 속성 |
enabled:Boolean [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 메뉴 항목이 활성화되어 있는지 여부를 제어합니다.
public function get enabled():Boolean public function set enabled(value:Boolean):void| 속성 |
isSeparator:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 항목이 메뉴 분리 기호 선인지 여부를 보고합니다.
NativeMenuItem 생성자의 isSeparator 매개 변수를 true로 설정하여 분리 기호 선을 만듭니다.
public function get isSeparator():Boolean| 속성 |
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: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참고 사항
| 속성 |
label:String [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 메뉴 항목의 표시 문자열입니다.
public function get label():String public function set label(value:String):void| 속성 |
menu:NativeMenu [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 항목을 포함하는 메뉴입니다.
public function get menu():NativeMenu| 속성 |
mnemonicIndex:int [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
메뉴 항목 레이블에 있는 니모닉 문자의 위치입니다.
지정된 위치의 문자는 메뉴 항목을 위한 니모닉 문자입니다. 인덱스는 0부터 시작하므로 첫 번째 문자에는 인덱스 0이 있습니다.
이 속성은 메뉴 니모닉을 사용하지 않는 운영 체제에서 무시됩니다.
public function get mnemonicIndex():int public function set mnemonicIndex(value:int):void| 속성 |
name:String [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 메뉴 항목의 이름입니다.
이름 값은 표시되지 않으며 로캘과 상관없는 식별자로 사용될 수 있습니다. 이름은 자동으로 지정되지 않습니다.
public function get name():String public function set name(value:String):void| 속성 |
submenu:NativeMenu [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
이 메뉴 항목과 연관된 하위 메뉴입니다.
NativeMenu 객체를 이 속성에 지정하면 메뉴 항목의 모양과 비헤이비어가 변경됩니다. 하위 메뉴 항목은 하위 메뉴 아이콘을 표시하며 더 이상 select 이벤트를 전달하지 않습니다.
public function get submenu():NativeMenu public function set submenu(value:NativeMenu):void참고 사항
| () | 생성자 |
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로 설정합니다.
|
참고 사항
| () | 메서드 |
| () | 메서드 |
override public function toString():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
NativeMenuItem 객체의 속성이 모두 포함된 문자열을 반환합니다.
반환값String — Event 객체의 속성이 모두 포함된 문자열입니다. |
| 이벤트 |
flash.events.Eventflash.events.Event.DISPLAYING| 런타임 버전: | AIR 1.0 |
항목을 포함하는 메뉴가 표시되기 직전 이 NativeMenuItem 객체에 의해 전달됩니다.
이벤트 객체의 target 속성은 이 NativeMenuItem 객체를 포함하는 NativeMenu 객체를 참조하고, currentTarget 속성은 이 NativeMenuItem을 참조합니다.
Event.DISPLAYING 상수는 displaying 이벤트 객체의 type 속성 값을 정의합니다.
참고: 이 이벤트는 "캡처 단계"를 통과하지 않으며 대상이 표시 목록에 있는지 여부에 관계없이 대상으로 직접 전달됩니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
| 속성 | 값 |
|---|---|
bubbles
|
false
|
cancelable
|
false
|
currentTarget
| 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target
| 표시될 객체입니다. |
| 이벤트 |
flash.events.Eventflash.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
| 항목이 선택된 객체입니다. |