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

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

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

AIR에서는 다음 메뉴 유형을 지원합니다.

메뉴인스턴스기능 테스트지원되는 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 인스턴스항상 지원됨전체아니오

메뉴는 명령, 하위 메뉴 및 분리 기호 선의 항목을 포함합니다. 메뉴 항목은 addItem(), addItemAt(), addSubmenu() 및 addSubmenuAt() 메서드와 함께 메뉴에 추가됩니다. 메뉴의 항목에 있어서 표시 순서는 메뉴 items 배열에 있는 항목의 순서와 같습니다.

하위 메뉴는 부모 메뉴에서 일치하는 메뉴 항목의 submenu 속성을 통해 자신의 부모 메뉴에 연결되어 있습니다. 윈도우의 루트 메뉴 및 응용 프로그램 메뉴에는 하위 메뉴 항목만 들어 있어야 합니다. 하위 메뉴가 없는 항목은 표시되지 않을 수 있으며 이러한 유형의 메뉴에 대한 사용자의 기대에 상반됩니다.

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

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

참고: NativeMenu 또는 ContextMenu 객체 중 하나를 사용하여 컨텍스트 메뉴를 설정할 수 있습니다. Flash Player는 NativeMenu 클래스가 아니라 ContextMenu 클래스만 지원합니다.

참고 사항

flash.display.InteractiveObject.contextMenu
flash.display.NativeMenuItem
flash.display.NativeWindow.menu
flash.desktop.DockIcon
flash.desktop.SystemTrayIcon
flash.desktop.NativeApplication.menu
flash.desktop.NativeApplication.icon

Public 속성
 속성다음에 의해 정의됨
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  AIR-only items : Array
이 메뉴에 있는 NativeMenuItem 객체의 배열입니다.
NativeMenu
  AIR-only numItems : int
[읽기 전용] 이 메뉴에 있는 NativeMenuItem 객체의 수입니다.
NativeMenu
  AIR-only parent : NativeMenu
[읽기 전용] 부모 메뉴입니다.
NativeMenu
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
Public 메서드
 메서드다음에 의해 정의됨
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
  
AIR-only addItem(item:NativeMenuItem):NativeMenuItem
메뉴의 맨 아래에 메뉴 항목을 추가합니다.
NativeMenu
  
AIR-only addItemAt(item:NativeMenuItem, index:int):NativeMenuItem
지정된 위치에 메뉴 항목을 삽입합니다.
NativeMenu
  
AIR-only addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem
새 메뉴 항목을 삽입하여 메뉴에 하위 메뉴를 추가합니다.
NativeMenu
  
AIR-only addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem
지정된 위치에 새 메뉴 항목을 삽입하여 메뉴에 하위 메뉴를 추가합니다.
NativeMenu
  
AIR-only clone():NativeMenu
메뉴의 복사본 및 모든 항목을 만듭니다.
NativeMenu
  
AIR-only containsItem(item:NativeMenuItem):Boolean
이 메뉴에 지정된 메뉴 항목이 포함되어 있는지 여부를 보고합니다.
NativeMenu
 Inherited
dispatchEvent(event:Event):Boolean
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
  
AIR-only display(stage:Stage, stageX:Number, stageY:Number):void
지정된 위치에서 이 메뉴를 표시합니다.
NativeMenu
  
AIR-only getItemAt(index:int):NativeMenuItem
지정된 인덱스의 메뉴 항목을 가져옵니다.
NativeMenu
  
AIR-only getItemByName(name:String):NativeMenuItem
지정된 이름의 메뉴 항목을 가져옵니다.
NativeMenu
  
AIR-only getItemIndex(item:NativeMenuItem):int
지정된 항목의 위치를 가져옵니다.
NativeMenu
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
  
AIR-only removeAllItems():void
메뉴에서 모든 항목을 제거합니다.
NativeMenu
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
  
AIR-only removeItem(item:NativeMenuItem):NativeMenuItem
지정된 메뉴 항목을 제거합니다.
NativeMenu
  
AIR-only removeItemAt(index:int):NativeMenuItem
지정된 인덱스의 메뉴 항목을 제거 및 반환합니다.
NativeMenu
  
AIR-only setItemIndex(item:NativeMenuItem, index:int):void
지정된 위치로 메뉴 항목을 이동합니다.
NativeMenu
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
toString():String
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
valueOf():Object
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
willTrigger(type:String):Boolean
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited
activate
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
 Inherited
deactivate
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
  
AIR-only displaying
메뉴가 표시되기 직전 이 NativeMenu 객체에 의해 전달됩니다.NativeMenu
  
AIR-only select
해당 메뉴 항목 중 하나 또는 자손 하위 메뉴 중 하나에 있는 항목이 선택될 때 이 NativeMenu 객체에 의해 전달됩니다.NativeMenu
속성 정보
AIR-only 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
AIR-only numItems속성 
numItems:int  [읽기 전용]

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

이 메뉴에 있는 NativeMenuItem 객체의 수입니다.



구현
    public function get numItems():int
AIR-only parent속성 
parent:NativeMenu  [읽기 전용]

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

부모 메뉴입니다.

루트(최상위) 메뉴 객체의 parent는 null입니다.



구현
    public function get parent():NativeMenu
메서드 정보
AIR-only addItem()메서드
public function addItem(item:NativeMenuItem):NativeMenuItem

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

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

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

매개 변수

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

반환값
NativeMenuItem

오류
ArgumentError — item이 null인 경우입니다.
 
ArgumentError — item이 다른 메뉴의 멤버인 경우입니다.
AIR-only 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 — 인덱스가 메뉴 items 배열의 경계를 벗어난 경우입니다.
AIR-only addSubmenu()메서드 
public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem

런타임 버전: AIR 1.0

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

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

매개 변수

submenu:NativeMenu — 추가할 하위 메뉴를 정의하는 NativeMenu 객체입니다.
 
label:String — 추가할 메뉴 항목용 표시 레이블입니다.

반환값
NativeMenuItem — 하위 메뉴용으로 만든 NativeMenuItem 객체입니다.
AIR-only addSubmenuAt()메서드 
public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem

런타임 버전: AIR 1.0

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

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

매개 변수

submenu:NativeMenu — 추가할 하위 메뉴를 정의하는 NativeMenu 객체입니다.
 
index:int — 추가할 메뉴 항목을 삽입할 이 메뉴의 items 배열에서의 위치입니다.
 
label:String — 추가할 메뉴 항목용 표시 레이블입니다.

반환값
NativeMenuItem — 하위 메뉴용으로 만든 NativeMenuItem 객체입니다.
AIR-only clone()메서드 
public function clone():NativeMenu

런타임 버전: AIR 1.0

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

반환값
NativeMenu
AIR-only containsItem()메서드 
public function containsItem(item:NativeMenuItem):Boolean

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

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

매개 변수

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

반환값
Boolean — item이 이 메뉴에 있을 경우 true입니다.
AIR-only display()메서드 
public function display(stage:Stage, stageX:Number, stageY:Number):void

런타임 버전: AIR 1.0

지정된 위치에서 이 메뉴를 표시합니다.

매개 변수

stage:Stage — 이 메뉴가 표시될 Stage 객체입니다.
 
stageX:Number — 이 메뉴가 표시될 stage의 원점을 기준으로 하는 가로 픽셀의 수입니다.
 
stageY:Number — 이 메뉴가 표시될 stage의 원점을 기준으로 하는 세로 픽셀의 수입니다.

AIR-only getItemAt()메서드 
public function getItemAt(index:int):NativeMenuItem

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

지정된 인덱스의 메뉴 항목을 가져옵니다.

매개 변수

index:int — 반환할 항목의 위치(0부터 시작)입니다.

반환값
NativeMenuItem — 메뉴에서 지정된 위치에 있는 NativeMenuItem 객체입니다.

오류
RangeError — index가 메뉴 items 배열의 경계를 벗어난 경우입니다.
AIR-only getItemByName()메서드 
public function getItemByName(name:String):NativeMenuItem

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

지정된 이름의 메뉴 항목을 가져옵니다.

참고: 메뉴 항목의 name 속성은 기본적으로 지정되어 있지 않습니다.

매개 변수

name:String — 조회할 문자열입니다.

반환값
NativeMenuItem — 지정된 이름의 NativeMenuItem 객체 또는 메뉴에 해당 항목이 없을 경우 null입니다.
AIR-only getItemIndex()메서드 
public function getItemIndex(item:NativeMenuItem):int

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

지정된 항목의 위치를 가져옵니다.

매개 변수

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

반환값
int — 이 메뉴에 지정된 항목의 위치(0부터 시작) 또는 해당 항목이 이 메뉴에 없을 경우 null입니다.
AIR-only removeAllItems()메서드 
public function removeAllItems():void

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

메뉴에서 모든 항목을 제거합니다.

AIR-only removeItem()메서드 
public function removeItem(item:NativeMenuItem):NativeMenuItem

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

지정된 메뉴 항목을 제거합니다.

매개 변수

item:NativeMenuItem — 이 메뉴에서 제거할 NativeMenuItem 객체입니다.

반환값
NativeMenuItem

오류
RangeError — item이 이 메뉴에 없는 경우입니다.
AIR-only removeItemAt()메서드 
public function removeItemAt(index:int):NativeMenuItem

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

지정된 인덱스의 메뉴 항목을 제거 및 반환합니다.

매개 변수

index:int — 제거할 항목의 위치(0부터 시작)입니다.

반환값
NativeMenuItem — 제거된 NativeMenuItem 객체입니다.

오류
RangeError — index가 이 메뉴 items 배열의 경계를 벗어난 경우입니다.
AIR-only 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 배열의 경계를 벗어난 경우입니다.
이벤트 정보
AIR-only displaying 이벤트
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.DISPLAYING

런타임 버전: AIR 1.0

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

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

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

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

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

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

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

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



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 02:16 AM -08:00