This page was saved using jaction on 2006-09-04 8:33:34.
Address: http://flexdocs.kr/docs/flex2/langref/flash/ui/ContextMenuItem.html
Title: flash.ui.ContextMenuItem (Flex™ 2 레퍼런스 가이드)  •  Size: 39635
Packageflash.ui
Classpublic final class ContextMenuItem
InheritanceContextMenuItem Inheritance EventDispatcher Inheritance Object

ContextMenuItem 클래스를 사용해, Flash Player 의 context menu에 표시하는 custom 메뉴 아이템을 작성합니다. 각 ContextMenuItem object에는, context menu에 표시되는 캡션 (텍스트)이 있습니다. context menu에 새로운 아이템을 추가하려면 , ContextMenu object의 customItems 배열에 아이템을 추가합니다.

ContextMenuItem 클래스의 property를 사용해, 특정의 메뉴 아이템을 유효 또는 무효로 해, 아이템을 표시 또는 비표시로 할 수 있습니다.

menuItemSelect 이벤트의 event 핸들러를 기술해, 유저가 메뉴 아이템을 선택했을 때에 메뉴 아이템에 기능을 추가합니다.

커스텀 메뉴 아이템은, context menu의 맨 위에, 즉, 어느 빌트인 아이템보다 위에 표시됩니다. custom 메뉴 아이템과 빌트인 아이템과의 사이에는 항상 separator가 표시됩니다.

제약 :

메모: 영어 이외의 시스템으로 실행되는 경우, 캡션 string는 영어의 일람 및 로컬라이즈 된 일람의 양쪽 모두라고 비교됩니다.

View the examples

See also

ContextMenu class
ContextMenuBuiltInItems class


Public property
 property정의
  caption : String
context menu에 표시하는 메뉴 아이템의 캡션 (텍스트)을 지정합니다.
ContextMenuItem
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  enabled : Boolean
지정된 메뉴 아이템이 유효한가 무효인지를 나타냅니다.
ContextMenuItem
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  separatorBefore : Boolean
지정된 메뉴 아이템 위에 separator를 표시할지 어떨지를 나타냅니다.
ContextMenuItem
  visible : Boolean
Flash Player 의 context menu를 표시할 경우에, 지정된 메뉴 아이템을 표시할지 어떨지를 나타냅니다.
ContextMenuItem
Public Methods
 Methods정의
  ContextMenuItem (caption:String , separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true)
ContextMenu.customItems 배열에 추가할 수 있는 새로운 ContextMenuItem object를 작성합니다.
ContextMenuItem
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
  clone ():ContextMenuItem
지정된 ContextMenuItem object의 복사를 작성해 돌려줍니다.
ContextMenuItem
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
이벤트
 이벤트일람정의
  menuItemSelect 유저가 context menu로부터 아이템을 선택했을 때에 dispatch됩니다. ContextMenuItem
property의 상세
captionproperty
caption:String   [read-write]

context menu에 표시하는 메뉴 아이템의 캡션 (텍스트)을 지정합니다. caption 값의 제약에 대해서는, ContextMenuItem 클래스의 개요를 참조해 주세요.

Implements
    public function get caption():String
    public function set caption(value:String ):void
enabledproperty 
enabled:Boolean   [read-write]

지정된 메뉴 아이템이 유효한가 무효인지를 나타냅니다.

디폴트치true.

Implements
    public function get enabled():Boolean
    public function set enabled(value:Boolean ):void
separatorBeforeproperty 
separatorBefore:Boolean   [read-write]

지정된 메뉴 아이템 위에 separator를 표시할지 어떨지를 나타냅니다.

메모 :커스텀 메뉴 아이템과 빌트인 메뉴 아이템의 사이에는 항상 separator가 표시됩니다.

디폴트치false.

Implements
    public function get separatorBefore():Boolean
    public function set separatorBefore(value:Boolean ):void
visibleproperty 
visible:Boolean   [read-write]

Flash Player 의 context menu를 표시할 경우에, 지정된 메뉴 아이템을 표시할지 어떨지를 나타냅니다.

디폴트치true.

Implements
    public function get visible():Boolean
    public function set visible(value:Boolean ):void
constructor    의 상세
ContextMenuItem()constructor   
public 함수 ContextMenuItem(caption:String , separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true)

ContextMenu.customItems 배열에 추가할 수 있는 새로운 ContextMenuItem object를 작성합니다.

Parameters
caption:String — 메뉴 아이템에 관련지을 수 있는 텍스트를 지정합니다. caption 값의 제약에 대해서는, ContextMenuItem 클래스의 개요를 참조해 주세요.
 
separatorBefore:Boolean (default = false) — context menu의 메뉴 아이템 위에 separator를 표시할지 어떨지를 지정합니다. 디폴트치는 false 입니다.
 
enabled:Boolean (default = true) — context menu의 메뉴 아이템이 유효한가 무효인지를 지정합니다. 디폴트치는 true (유효)입니다. 이 Parameters는 옵션입니다.
 
visible:Boolean (default = true) — 메뉴 아이템을 표시할까 비표시로 하는지를 지정합니다. 디폴트치는 true (표시한다)입니다.
Methods의 상세
clone()Methods
public function clone():ContextMenuItem

지정된 ContextMenuItem object의 복사를 작성해 돌려줍니다. 복사에는, 원의 object의 모든 property가 포함됩니다.

반환값
ContextMenuItem — 원의 object의 모든 property를 포함한 ContextMenuItem object입니다.
이벤트의 상세
menuItemSelectevent 
Event object type: flash.events.ContextMenuEvent
ContextMenuEvent.type property = flash.events.ContextMenuEvent.MENU_ITEM_SELECT

유저가 context menu로부터 아이템을 선택했을 때에 dispatch됩니다. 유저는, 유저의 pointing device의 작은 버튼을 클릭하는 것으로써, context menu를 생성합니다.

menuItemSelect event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

PropertyValue
bubblesfalse
cancelablefalse 는, 캔슬하는 디폴트의 동작이 없는 것을 나타냅니다.
contextMenuOwner메뉴를 관련지을 수 있는 표시 리스트 object입니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
mouseTarget유저가 context menu를 표시하기 위해서 오른쪽 클릭한 표시 리스트 object입니다.
target선택된 ContextMenuItem object입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.
Examples

다음의 예에서는, 클래스 ContextMenuBuiltInItemsExample (을)를 사용해, 디폴트의 context menu 아이템을 스테이지로부터 삭제해, 새로운 메뉴 아이템을 추가합니다. 여기에서는 이하의 순서를 실행합니다.
  1. property myContextMenu 가 선언되어 새로운 ContextMenu object에 할당할 수 있습니다.
  2. Methods removeDefaultItems() 가 불려 갑니다. 이 Methods에 의해, 모든 빌트인 문맥 메뉴 아이템이 삭제됩니다. 다만, 프린트를 제외합니다.
  3. Methods addCustomMenuItems() 가 불려 갑니다. 이 Methods에 의해, Hello World 라고 하는 메뉴 아이템이 customItems 배열에 배치됩니다. 배열의 push() Methods가 사용됩니다.
  4. Hello World context menu 아이템은, 스테이지의 문맥 메뉴 아이템 일람에 추가됩니다.
  5. 텍스트 "여기를 오른쪽 클릭" 을 가지는 TextField object가 스테이지에 추가됩니다.
package {
    import flash.ui.ContextMenu;
    import flash.ui.ContextMenuItem;
    import flash.ui.ContextMenuBuiltInItems;
    import flash.display.Sprite;
    import flash.text.TextField;

    public class ContextMenuItemExample extends Sprite {
        private var myContextMenu:ContextMenu;

        public function ContextMenuItemExample() {
            myContextMenu = new ContextMenu();
            removeDefaultItems();
            addCustomMenuItems();
            this.contextMenu = myContextMenu;
            addChild(createLabel());
        }

        private function removeDefaultItems() :void {
            myContextMenu.hideBuiltInItems();

            var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems;
            defaultItems.print = true;
        }

        private function addCustomMenuItems() :void {
            var item:ContextMenuItem = new ContextMenuItem("Hello World");
            myContextMenu.customItems.push(item);
        }
        
        private function createLabel() :TextField {
            var txtField:TextField = new TextField();
            txtField.text = "Right Click Here";
            return txtField;
        }
    }
}






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/flash/ui/ContextMenuItem.html