EventDispatcher  - AS3

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

EventDispatcher 클래스는 일반적으로 기본 클래스로 사용되므로 대부분의 개발자들은 이 생성자 함수를 사용할 필요가 없습니다. 그러나 IEventDispatcher 인터페이스를 구현하는 고급 개발자들은 이 생성자를 사용해야 합니다. EventDispatcher를 확장할 수 없어서 대신 IEventDispatcher 인터페이스를 구현해야 하는 경우에는 이 생성자를 사용하여 EventDispatcher 클래스의 인스턴스를 집계합니다.

리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. 표시 목록의 모든 노드에서 특정 유형의 이벤트, 단계, 우선 순위에 대한 이벤트 리스너를 등록할 수 있습니다.

이벤트 리스너의 등록을 마친 뒤에는 addEventListener()를 추가로 호출하여 그 우선 순위를 변경할 수 없습니다. 리스너의 우선 순위를 변경하려면 먼저 removeListener()를 호출해야 합니다. 그런 다음 해당 리스너를 새로운 우선 순위 레벨로 다시 등록할 수 있습니다.

일단 리스너가 등록된 뒤에 type 또는 useCapture 값을 달리하여 addEventListener()를 이어서 호출하면 별도의 리스너 등록이 생성된다는 것에 유의합니다. 예를 들어 useCapture가 true로 설정된 리스너를 등록하면 이 리스너는 캡처 단계 동안에만 수신합니다. 그러나 useCapture를 false로 설정하고 동일한 리스너 객체를 사용하여 addEventListener()를 다시 호출하면 별도로 두 개의 리스너가 등록되어, 한 리스너는 캡처 단계 동안 수신하고 다른 하나는 대상 및 버블링 단계 동안 수신합니다.

대상 단계 또는 버블링 단계 전용의 이벤트 리스너를 등록할 수는 없습니다. 버블링은 대상 노드의 조상에만 적용되기 때문에 이들 단계는 등록 과정에서 하나로 통합됩니다.

사용하지 않는 이벤트 리스너는 removeEventListener()를 호출하여 제거하도록 합니다. 이렇게 하지 않으면 메모리 문제가 발생할 수 있습니다. useWeakReference 매개 변수가 true로 설정되지 않은 경우 전달하는 객체가 있는 한, 가비지 수집기는 이벤트 리스너를 제거하지 않으므로 리스너는 메모리에서 자동으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도 연결된 이벤트 리스너는 복사되지 않습니다. 새로 만든 노드에 이벤트 리스너가 필요한 경우, 노드를 만든 후 리스너를 연결해야 합니다. 그러나 EventDispatcher 인스턴스를 이동할 때에는 연결된 이벤트 리스너도 함께 이동됩니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 등록하는 경우, 그 이벤트 리스너는 현재 단계 동안에는 트리거되지 않지만 이벤트 흐름에서 이후 단계(예: 버블링 단계) 동안에는 트리거될 수 있습니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 제거하는 경우, 그 리스너는 현재 액션에 의해 트리거됩니다. 일단 제거된 이벤트 리스너는 이후의 처리를 위해 재등록하지 않는 한 다시는 호출되지 않습니다.

매개 변수

function(evt:Event):void

이벤트를 이벤트 흐름으로 전달합니다. 이벤트 대상은 dispatchEvent() 메서드가 호출된 EventDispatcher 객체입니다.

매개 변수

EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. 이를 통해 이벤트 흐름 계층 구조의 어떤 지점에서 EventDispatcher 객체가 이벤트 유형 처리를 변경했는지 확인할 수 있습니다. 특정 이벤트 유형이 실제로 이벤트 리스너를 트리거하는지를 확인하려면 willTrigger()를 사용합니다.

hasEventListener()와 willTrigger() 간의 차이점은 hasEventListener()가 자신이 속한 객체만 검사하는 반면 willTrigger()는 type 매개 변수에 의해 지정된 이벤트의 전체 흐름을 검사한다는 점입니다.

LoaderInfo 객체로부터 hasEventListener()가 호출된 경우에는 해당 호출자가 액세스할 수 있는 리스너만 고려의 대상이 됩니다.

매개 변수

관련 API 요소

EventDispatcher 객체에서 리스너를 제거합니다. EventDispatcher 객체와 함께 등록된 리스너 중 일치하는 것이 없다면 이 메서드를 호출해도 아무 영향이 없습니다.

매개 변수

이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. 지정된 유형의 이벤트가 이 EventDispatcher 객체나 그 자손으로 전달되었을 때 이벤트 흐름의 특정 단계에서 이벤트 리스너가 트리거되는 경우 이 메서드는 true를 반환합니다.

hasEventListener() 메서드와 willTrigger() 메서드 간의 차이점은 hasEventListener()가 자신이 속한 객체만 검사하는 반면 willTrigger() 메서드는 type 매개 변수에 의해 지정된 이벤트의 전체 이벤트 흐름을 검사한다는 점입니다.

LoaderInfo 객체로부터 willTrigger()가 호출된 경우에는 해당 호출자가 액세스할 수 있는 리스너만 고려의 대상이 됩니다.

매개 변수

[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. 이 이벤트는 브로드캐스트 이벤트입니다. 즉, 이 이벤트에 등록된 리스너가 있는 모든 EventDispatcher 객체에서 전달합니다. 브로드캐스트 이벤트에 대한 자세한 내용은 DisplayObject 클래스를 참조하십시오.

참고: 이 이벤트에는 "캡처 단계" 또는 "버블링 단계"가 없으므로 대상이 표시 목록에 있는지 여부에 관계없이 잠재적인 모든 대상에 이벤트 리스너를 직접 추가해야 합니다.

AIR for TV 장치는 이 이벤트를 자동으로 전달하지 않습니다. 하지만 수동으로 전달할 수는 있습니다.

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

관련 API 요소

[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. 이 이벤트는 브로드캐스트 이벤트입니다. 즉, 이 이벤트에 등록된 리스너가 있는 모든 EventDispatcher 객체에서 전달합니다. 브로드캐스트 이벤트에 대한 자세한 내용은 DisplayObject 클래스를 참조하십시오.

참고: 이 이벤트에는 "캡처 단계" 또는 "버블링 단계"가 없으므로 대상이 표시 목록에 있는지 여부에 관계없이 잠재적인 모든 대상에 이벤트 리스너를 직접 추가해야 합니다.

AIR for TV 장치는 이 이벤트를 자동으로 전달하지 않습니다. 하지만 수동으로 전달할 수는 있습니다.

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

관련 API 요소

1. EventDispatcherExample의 생성자는 로컬 변수 dispatcher를 생성하여 새로운 CustomDispatcher 인스턴스에 할당합니다.
2. CustomDispatcher 내에서 이벤트에 action이라는 이름이 지정되고 doAction() 메서드가 선언되도록 문자열을 설정합니다. 이 메서드는 호출 시 action 이벤트를 만들고 EventDispatcher.dispatchEvent()를 사용하여 이를 전달합니다.
3. 그러면 dispatcher 속성을 통해 action 이벤트 리스너와 연관된 구독자 메서드 actionHandler()가 추가되며, 이는 이벤트 전달 시 이벤트에 정보를 출력합니다.
4. doAction() 메서드가 호출되어 action 이벤트를 전달합니다.

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));
    }
}