This page was saved using jaction on 2006-09-04 8:33:42.
Address: http://flexdocs.kr/docs/flex2/langref/flash/events/FocusEvent.html
Title: flash.events.FocusEvent (Flex™ 2 레퍼런스 가이드)  •  Size: 68567
Packageflash.events
Classpublic class FocusEvent
InheritanceFocusEvent Inheritance Event Inheritance Object

유저가 표시 리스트의 1 개의 object로부터 다른 object로 포커스를 변경하면, Flash® Player 에 의해 FocusEvent object가 dispatch됩니다. 다음의 4 종류의 포커스 이벤트가 있습니다.

View the examples



Public property
 property정의
 Inheritedbubbles : Boolean
이벤트가 바브 링 이벤트인 가 어떤가를 나타냅니다.
Event
 Inheritedcancelable : Boolean
이벤트에 관련지을 수 있었던 행동을 회피할 수 있을지 어떨지를 나타냅니다.
Event
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 InheritedcurrentTarget : Object
event listener로 Event object를 액티브하게 처리하고 있는 object입니다.
Event
 InheritedeventPhase : uint
event 플로우(flow)의 현재의 단계입니다.
Event
  keyCode : uint
keyFocusChange 이벤트를 방아쇠 하기 위해서 밀린 키의 키코드치입니다.
FocusEvent
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  relatedObject : InteractiveObject
포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스에의 참조입니다.
FocusEvent
  shiftKey : Boolean
Shift 키모디파이아가 액티브하게 되어 있는지 어떤지를 나타냅니다. 액티브한 경우, 값은 true 입니다.
FocusEvent
 Inheritedtarget : Object
event 타겟입니다.
Event
 Inheritedtype : String
이벤트의 형태입니다.
Event
Public Methods
 Methods정의
  FocusEvent (type:String , bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)
포커스 이벤트에 관한 특정의 정보를 포함한 Event object를 작성합니다.
FocusEvent
  clone ():Event
FocusEvent object의 복사를 작성해, 각 property의 값을 원의 property의 값과 일치하도록(듯이) 설정합니다.
FocusEvent
 InheritedformatToString (className:String , ... arguments):String
custom Event 클래스에 toString() Methods를 Implements하기 위한 유틸리티 함수입니다.
Event
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisDefaultPrevented ():Boolean
이벤트로 preventDefault() 가 불려 갔는지 어떠했는지를 체크합니다.
Event
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpreventDefault ():void
이벤트의 디폴트 행동을 캔슬할 수 있는 경우에, 그 행동을 캔슬합니다.
Event
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedstopImmediatePropagation ():void
event 플로우(flow)의 현재의 노드 및 후속 하는 노드로, event listener가 처리되지 않게 합니다.
Event
 InheritedstopPropagation ():void
event 플로우(flow)의 현재의 노드에 후속 하는 노드로, event listener가 처리되지 않게 합니다.
Event
  toString ():String
FocusEvent object의 모든 property를 포함한 string를 돌려줍니다.
FocusEvent
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
Public 정수
 정수정의
 InheritedACTIVATE : String = "activate"
[static] activate event object의 type property의 값을 정의합니다.
Event
 InheritedADDED : String = "added"
[static] added event object의 type property의 값을 정의합니다.
Event
 InheritedCANCEL : String = "cancel"
[static] cancelevent object의 type property의 값을 정의합니다.
Event
 InheritedCHANGE : String = "change"
[static] change event object의 type property의 값을 정의합니다.
Event
 InheritedCLOSE : String = "close"
[static] close event object의 type property의 값을 정의합니다.
Event
 InheritedCOMPLETE : String = "complete"
[static] complete event object의 type property의 값을 정의합니다.
Event
 InheritedCONNECT : String = "connect"
[static] connect event object의 type property의 값을 정의합니다.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] deactivate event object의 type property의 값을 정의합니다.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] enterFrame event object의 type property의 값을 정의합니다.
Event
  FOCUS_IN : String = "focusIn"
[static] focusIn event object의 type property의 값을 정의합니다.
FocusEvent
  FOCUS_OUT : String = "focusOut"
[static] focusOut event object의 type property의 값을 정의합니다.
FocusEvent
 InheritedID3 : String = "id3"
[static] id3 event object의 type property의 값을 정의합니다.
Event
 InheritedINIT : String = "init"
[static] init event object의 type property의 값을 정의합니다.
Event
  KEY_FOCUS_CHANGE : String = "keyFocusChange"
[static] keyFocusChange event object의 type property의 값을 정의합니다.
FocusEvent
  MOUSE_FOCUS_CHANGE : String = "mouseFocusChange"
[static] mouseFocusChange event object의 type property의 값을 정의합니다.
FocusEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] mouseLeave event object의 type property의 값을 정의합니다.
Event
 InheritedOPEN : String = "open"
[static] open event object의 type property의 값을 정의합니다.
Event
 InheritedREMOVED : String = "removed"
[static] removed event object의 type property의 값을 정의합니다.
Event
 InheritedRENDER : String = "render"
[static] render event object의 type property의 값을 정의합니다.
Event
 InheritedRESIZE : String = "resize"
[static] resize event object의 type property의 값을 정의합니다.
Event
 InheritedSCROLL : String = "scroll"
[static] scroll event object의 type property의 값을 정의합니다.
Event
 InheritedSELECT : String = "select"
[static] select event object의 type property의 값을 정의합니다.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] soundComplete event object의 type property의 값을 정의합니다.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] tabChildrenChange event object의 type property의 값을 정의합니다.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] tabEnabledChange event object의 type property의 값을 정의합니다.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] tabIndexChange event object의 type property의 값을 정의합니다.
Event
 InheritedUNLOAD : String = "unload"
[static] unload event object의 type property의 값을 정의합니다.
Event
property의 상세
keyCodeproperty
keyCode:uint   [read-write]

keyFocusChange 이벤트를 방아쇠 하기 위해서 밀린 키의 키코드치입니다.

Implements
    public function get keyCode():uint
    public function set keyCode(value:uint ):void
relatedObjectproperty 
relatedObject:InteractiveObject   [read-write]

포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스에의 참조입니다. 예를 들어,focusOut 이벤트가 발생했을 경우,relatedObject 는 포커스를 얻은 InteractiveObject 인스턴스를 나타냅니다.

Implements
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject ):void
shiftKeyproperty 
shiftKey:Boolean   [read-write]

Shift 키모디파이아가 액티브하게 되어 있는지 어떤지를 나타냅니다. 액티브한 경우, 값은 true 입니다. 이외의 경우, 값은 false 입니다. 이 property는, FocusEvent 의 타입이 keyFocusChange 의 경우만 사용됩니다.

Implements
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean ):void
constructor    의 상세
FocusEvent()constructor   
public 함수 FocusEvent(type:String , bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)

포커스 이벤트에 관한 특정의 정보를 포함한 Event object를 작성합니다. event listener에게는 Event object가 Parameters로서 건네받습니다.

Parameters
type:String — 이벤트의 타입입니다. 유효한 값은 다음과 같습니다. FocusEvent.FOCUS_IN,FocusEvent.FOCUS_OUT,FocusEvent.KEY_FOCUS_CHANGE, 및 FocusEvent.MOUSE_FOCUS_CHANGE.
 
bubbles:Boolean (default = true) — Event object가 event 플로우(flow)의 바브 링 단계에서 처리될지 어떨지를 판단합니다.
 
cancelable:Boolean (default = false) — Event object가 캔슬 가능한가 어떤가를 판단합니다.
 
relatedObject:InteractiveObject (default = null) — 포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스를 나타냅니다. 예를 들어,focusIn 이벤트가 발생했을 경우,relatedObject 는 포커스를 잃은 InteractiveObject 를 나타냅니다.
 
shiftKey:Boolean (default = false) — Shift 키모디파이아가 액티브하게 되어 있는지 어떤지를 나타냅니다.
 
keyCode:uint (default = 0)keyFocusChange 이벤트를 방아쇠 하기 위해서 밀린 키의 코드를 나타냅니다.

See also

Methods의 상세
clone()Methods
public override function clone():Event

FocusEvent object의 복사를 작성해, 각 property의 값을 원의 property의 값과 일치하도록(듯이) 설정합니다.

반환값
Event — 원의 object와 같은 property치를 포함한 새로운 FocusEvent object입니다.
toString()Methods 
public override function toString():String

FocusEvent object의 모든 property를 포함한 string를 돌려줍니다. string는 다음의 형식입니다.

[FocusEvent type=value bubbles=value cancelable=value relatedObject=value shiftKey=value]

반환값
String — FocusEvent object의 모든 property를 포함한 string입니다.
정수의 상세
FOCUS_IN정수
public static const FOCUS_IN:String = "focusIn"

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

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

PropertyValue
bubblestrue
cancelablefalse 는, 캔슬하는 디폴트의 동작이 없는 것을 나타냅니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
keyCode0. keyFocusChange 이벤트에게만 적용됩니다.
relatedObject포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스입니다.
shiftKeyfalse. keyFocusChange 이벤트에게만 적용됩니다.
target포커스를 받은 InteractiveObject 인스턴스입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.

See also

FOCUS_OUT정수 
public static const FOCUS_OUT:String = "focusOut"

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

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

PropertyValue
bubblestrue
cancelablefalse 는, 캔슬하는 디폴트의 동작이 없는 것을 나타냅니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
keyCode0. keyFocusChange 이벤트에게만 적용됩니다.
relatedObject포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스입니다.
shiftKeyfalse. keyFocusChange 이벤트에게만 적용됩니다.
target포커스를 잃은 InteractiveObject 인스턴스입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.

See also

KEY_FOCUS_CHANGE정수 
public static const KEY_FOCUS_CHANGE:String = "keyFocusChange"

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

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

PropertyValue
bubblestrue
cancelabletrue. preventDefault() Methods를 호출해 디폴트의 동작을 취소합니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
keyCodekeyFocusChange 이벤트를 방아쇠 하기 위해서 밀린 키의 키코드치입니다.
relatedObject포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스입니다.
shiftKeyShift 키모디파이아가 액티브하게 되어 있는 경우는 true, 그 이외의 경우는 false 입니다.
target현재 포커스를 가지고 있는 InteractiveObject 인스턴스입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.

See also

MOUSE_FOCUS_CHANGE정수 
public static const MOUSE_FOCUS_CHANGE:String = "mouseFocusChange"

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

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

PropertyValue
bubblestrue
cancelabletrue. preventDefault() Methods를 호출해 디폴트의 동작을 취소합니다.
currentTargetevent listener로 Event object를 액티브하게 처리하고 있는 object입니다.
keyCode0. keyFocusChange 이벤트에게만 적용됩니다.
relatedObject포커스의 변경의 영향을 받는 보완적인 InteractiveObject 인스턴스입니다.
shiftKeyfalse. keyFocusChange 이벤트에게만 적용됩니다.
target현재 포커스를 가지고 있는 InteractiveObject 인스턴스입니다. target 는, 반드시 event listener를 등록한 표시 리스트내의 object라고는 할 수 없습니다. 현재 이벤트를 처리하고 있는 표시 리스트내의 object에 액세스 하려면 ,currentTarget property를 사용합니다.

See also

Examples

다음의 예에서는 FocusEventExampleCustomSprite 클래스를 사용해, 이벤트의 capther나 정보의 출력을 위해서(때문에), 스테이지에 묘화 된 아이템과 포커스를 조합해 사용하는 방법을 나타냅니다. 이 예에서는, 다음의 처리를 실행합니다.
  1. Sprite 형의 property child 와 uint 형의 property childCount 를 선언합니다.
  2. for 루프에 의해, (0,0)의 위치에 밝은 청색의 사각형이 5 개 작성됩니다. 여기에서는, 우선, 새로운 CustomSprite 인스턴스에 child 를 할당합니다. CustomSprite object가 작성될 때마다, 다음의 처리가 실행됩니다.
    • uint 형의 size property가 50 픽셀로 설정되어bgColor 가 밝은 청색으로 설정됩니다.
    • Sprite 클래스의 buttonMode property와useHandCursor property는, constructor    내에서 true 로 설정됩니다.
    • 타입이 click 의 event listener가, 관련하는 subscribers clickHandler() 와 함께 인스턴스화 됩니다. 이 subscribers메솟드는, Sprite 형의 로컬 변수 target 를 작성해, 클릭된 박스에 이 변수를 할당합니다. 계속되어, 스테이지의 포커스를 target.
    • draw() Methods가 불려 가 50 × 50 픽셀의 사각형이 작성됩니다. 그 때문에(위해), Graphics 클래스의 beginFill(),drawRect(), 및 endFill() Methods와 인스턴스 property가 불려 갑니다.
  3. for 루프에서는,configureListeners() Methods가 불려 가 3 개의 event listener와 subscribers를 인스턴스화합니다.
    • focusInfocusInHandler() 는, 클릭된 표시 리스트 object (박스)에 대한 click 이벤트 의 다음에 dispatch됩니다.
    • focusOutfocusOutHandler() 는, 다른 박스가 클릭되었을 때, 또는 포커스가 스테이지를 떠났을 때 (예를 들어, Flash Player 의 외측이 클릭되었을 경우)에 dispatch됩니다.
    • keyFocusChangekeyFocusChangeHandler() 는, Tab 키, 왼쪽 커서 키 또는 오른쪽 커서 키에 의해 표시 리스트 object가 선택되었을 때에 dispatch됩니다. keyFocusChangeHandler() Methods는, 왼쪽 커서 키와 오른쪽 커서 키를 트랩 합니다. 다만 이것에 가세해, 이러한 키를 무효로 하기 위해서(때문에) preventDefault() Methods가 불려 갑니다.
  4. for 루프에서는,addChild() 를 사용해, 각 사각형이 표시 리스트에 추가되어 모두 같은 area에 표시됩니다.
  5. 다음에, constructor    이 refreshLayout() 를 호출합니다. 이것에 의해, 오렌지색의 사각형이, 디스플레이의 최상부 (y = 0)에 옆일렬에 5 픽셀 걸러서 표시됩니다.
package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.events.FocusEvent;
    import flash.events.IEventDispatcher;

    public class FocusEventExample extends Sprite {
        private var gutter:uint = 5;
        private var childCount:uint = 5;

        public function FocusEventExample() {
            var child:Sprite;
            for(var i:uint; i < childCount; i++) {
                child = new CustomSprite();
                configureListeners(child);
                addChild(child);
            }
            refreshLayout();
        }

        private function configureListeners(dispatcher:IEventDispatcher) :void {
            dispatcher.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
            dispatcher.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
            dispatcher.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, keyFocusChangeHandler);
            dispatcher.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, mouseFocusChangeHandler);
        }

        private function refreshLayout() :void {
            var ln:uint = numChildren;
            var child:DisplayObject = getChildAt(0);
            var lastChild:DisplayObject = child;
            for(var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = lastChild.x + lastChild.width + gutter;
                lastChild = child;
            }
        }

        private function focusInHandler(event:FocusEvent) :void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("focusInHandler: " + target.name);
        }

        private function focusOutHandler(event:FocusEvent) :void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("focusOutHandler: " + target.name);
        }

        private function keyFocusChangeHandler(event:FocusEvent) :void {
            if(event.keyCode == 39 || event.keyCode == 37){
                event.preventDefault()
            }
            var target:CustomSprite = CustomSprite(event.target);
            trace("keyFocusChangeHandler: " + target.name);
        }
        private function mouseFocusChangeHandler(event:FocusEvent) :void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("mouseFocusChangeHandler: " + target.name);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class CustomSprite extends Sprite {
    private var size:uint = 50;
    private var bgColor:uint = 0x00CCFF;

    public function CustomSprite() {
        buttonMode = true;
        useHandCursor = true;
        addEventListener(MouseEvent.CLICK, clickHandler);
        draw(size, size);
    }

    private function draw(w:uint, h:uint) :void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent) :void {
        var target:Sprite = Sprite(event.target);
        trace("clickHandler: " + target.name);
        stage.focus = target;
    }
}






 

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

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