EventDispatcher 클래스의 인스턴스를 집약합니다.

EventDispatcher 클래스는, 일반적으로 기본 클래스로서 사용됩니다. 이 때문에, 대부분의 개발자는 이 constructor　 　 함수를 사용할 필요가 없습니다. 다만, IEventDispatcher 인터페이스를 Implements하는 상급 개발자는, 이 constructor　 　 을 사용할 필요가 있습니다. EventDispatcher 클래스를 확장할 수 없기 때문에, 대신에 IEventDispatcher 인터페이스를 Implements할 필요가 있는 경우는, 이 constructor　 　 을 사용해, EventDispatcher 클래스의 인스턴스를 집약합니다.

event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다. event listener는, 특정의 타입의 이벤트, 단계, 및 우선도에 관한 표시 리스트내의 모든 노드에 등록할 수 있습니다.

event listener가 정상적으로 등록된 후에,addEventListener() 를 한층 더 호출해 우선도를 변경할 수 없습니다. listener의 우선도를 변경하려면 , 최초로 removeListener() 를 호출할 필요가 있습니다. 그 후, 같은 listener를 새로운 우선도 레벨로 재차 등록할 수 있습니다.

listener가 등록된 후에,type 또는 useCapture 에 다른 값을 설정해 재차 addEventListener() 를 호출하면, 다른 listener 등록이 작성되는 것에 주의해 주세요. 예를 들어, 최초로 listener를 등록할 경우에 useCapture 를 true 로 설정하면, 그 listener는 capther 단계만으로 리스닝 합니다. useCapture 에 false 를 설정해, 같은 listener objects를 사용해 재차 addEventListener() 를 호출하면, 다른 2 살의 listener가 등록됩니다. 1 개은 capther 단계에서 리스닝 하는 listener로, 이제(벌써) 1 개은 타겟 단계와 바브 링 단계에서 리스닝 하는 listener입니다.

타겟 단계 또는 바브 링 단계만을 대상으로 하는 event listener를 등록할 수 없습니다. 등록시에 이러한 단계가 짜 합쳐지는 것은, 바브 링은 타겟 노드의 조상 밖에 적용되지 않기 때문입니다.

event listener가 불필요하게 되었을 경우는,removeEventListener() 를 호출해, event listener를 삭제합니다. 삭제하지 않는 경우, 메모리의 문제가 발생할 가능성이 있습니다. 가베지 컬렉터는 참조를 가지는 object를 삭제하지 않기 때문에, 등록되어 있는 event listener에 관계한 object는 메모리로부터 자동적으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도, 거기에 관련지을 수 있고 있는 event listener는 복사되지 않습니다. 새롭게 작성한 노드에 event listener가 필요한 경우는, 노드를 작성한 후에, listener를 관련지을 필요가 있습니다. 다만, EventDispatcher 인스턴스를 이동했을 경우는, 관련지을 수 있고 있는 event listener도 함께 이동됩니다.

이벤트가 노드로 처리될 때, event listener가 그 노드에 등록중이면, event listener는 현재의 단계에서는 방아쇠 되지 않습니다. 다만, 바브 링 단계 등, event 플로우(flow)의 뒤의 단계에서 방아쇠 할 수가 있습니다.

이벤트가 노드로 처리되고 있을 때 event listener가 노드로부터 삭제되었을 경우에서도, 이벤트는 현재의 액션에 의해 방아쇠 됩니다. 삭제된 후는, 그 후의 처리로 다시 등록되지 않는 이상 event listener는 두 번 다시 불려 가지 않습니다.

See also

이벤트를 event 플로우(flow)에 dispatch합니다. event 타겟은 EventDispatcher object입니다. 이것에 대해서 dispatchEvent() Methods가 불려 갑니다.

EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다. 이것에 의해, EventDispatcher object가 event 타입의 처리를 event 플로우(flow) 계층의 어디서 변경했는지를 판단할 수 있습니다. 특정의 event 타입이 실제로 event listener를 방아쇠 할지 어떨지를 판별하려면 ,willTrigger() 를 사용합니다.

hasEventListener() 와 willTrigger() 의 차이는,hasEventListener() 에서는 자신이 속하는 object만 검증되어willTrigger() 에서는 type Parameters로 지정된 이벤트의 event 플로우(flow) 전체가 검증되는 것입니다.

hasEventListener() 가 LoaderInfo object로부터 불려 갔을 경우는, 호출측을 액세스 할 수 있는 listener만 고려됩니다.

관련 항목

EventDispatcher object로부터 listener를 삭제합니다. 대응하는 listener가 EventDispatcher object에 등록되지 않은 경우는, 이 Methods를 호출해도 효과는 없습니다.

관련 항목

지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다. 지정된 타입의 이벤트가 이 EventDispatcher object 또는 그 자손에게 dispatch되었을 때에, event listener가 event 플로우(flow)의 임의의 단계에서 방아쇠 되는 경우, 이 Methods는 true 를 돌려줍니다.

hasEventListener() Methods와 willTrigger() Methods의 차이는,hasEventListener() 에서는 자신이 속하는 object만 검증되어willTrigger() Methods에서는 type Parameters로 지정된 이벤트의 event 플로우(flow) 전체가 검증되는 것입니다.

willTrigger() 가 LoaderInfo object로부터 불려 갔을 경우는, 호출측을 액세스 할 수 있는 listener만 고려됩니다.

1. EventDispatcherExample 의 constructor　 　 은, 로컬 변수 dispatcher 를 작성해, 그것을 새로운 CustomDispatcher 인스턴스에 할당합니다.
2. CustomDispatcher 에서는, 이벤트가 action 라는 이름으로,doAction() Methods를 선언하도록(듯이) string가 설정되어 있습니다. 이 Methods가 불려 가면,EventDispatcher.dispatchEvent() 를 사용해, action 이벤트가 작성되어 dispatch됩니다.
3. 다음에,dispatcher property가 사용되어,action event listener와 거기에 관련하는 subscribers메솟드 actionHandler() 가 추가됩니다. 이 Methods는, 이벤트가 dispatch되면, 이벤트에 관한 정보만을 출력합니다.
4. doAction() Methods가 불려 가면,action 이벤트가 dispatch됩니다.

package {
    import flash.display.Sprite;
    import flash.events.Event;

    public class EventDispatcherExample extends Sprite {

        public function EventDispatcherExample() {
            var dispatcher:CustomDispatcher = new CustomDispatcher();
            dispatcher.addEventListener(CustomDispatcher.ACTION, actionHandler);
            dispatcher.doAction();
        }

        private function actionHandler(event:Event) :void {
            trace("actionHandler: " + event);
        }
    }
}

import flash.events.EventDispatcher;
import flash.events.Event;

class CustomDispatcher extends EventDispatcher {
    public static var ACTION:String = "action";

    public function doAction() :void {
        dispatchEvent(new Event(CustomDispatcher.ACTION));
    }
}