彙總 EventDispatcher 類別的實體。

EventDispatcher 類別通常會被當成基底類別來使用，也就是說，大部分的開發人員並不需要用到這個建構函數。 不過，進階的開發人員在實作 IEventDispatcher 介面時會需要用到這個建構函式。 如果您無法擴充 EventDispatcher 類別，而必須改為實作 IEventDispatcher 介面，請使用這個建構函式來彙總 EventDispatcher 類別的實體。

會在 EventDispatcher 物件註冊事件偵聽程式¡以便讓偵聽程式收到事件的通知。 您可以在顯示清單上的所有節點，為特定類型的事件、階段與優先順序註冊事件偵聽程式。

當您成功註冊事件偵聽程式後，就不可以透過對 addEventListener() 的額外呼叫來變更其優先順序。 若要變更偵聽程式的優先順序，您必須先呼叫 removeListener()。 然後，您就可以使用新的優先順序等級來重新註冊偵聽程式。

請記住，一旦您註冊了偵聽程式，對 addEventListener() 進行後續呼叫，若使用不同的 type 或 useCapture 值，將會導致建立個別的偵聽程式註冊程序。 例如，如果您先將 useCapture 設為 true 來註冊偵聽程式，則只會在捕捉階段進行偵聽。 如果您使用相同的偵聽程式物件，再次呼叫 addEventListener() (但將 useCapture 設為 false) 會得到兩個不同的偵聽程式： 一個會在捕捉階段進行偵聽，另一個則會在目標與反昇階段進行偵聽。

您無法單獨針對目標階段或反昇階段註冊事件偵聽程式。 由於反昇階段只適用於目標節點的祖先，因此這兩種階段必須一起進行註冊。

如果您不再需要事件偵聽程式，可以呼叫 removeEventListener() 來移除它，否則可能產生記憶體問題。 含有已註冊之事件偵聽程式的物件不會自動從記憶體中移除，因為垃圾回收器不會將仍保有參照的物件移除。

複製 EventDispatcher 實體並不會將附加在該實體上的事件偵聽程式一併複製 (如果新建立的節點需要事件偵聽程式，則您必須在建立節點後再附加偵聽程式)。 然而，如果您移動了 EventDispatcher 實體，則附加的事件偵聽程式也會跟著移動。

若於此節點正在處理事件的同時將事件偵聽程式註冊到某個節點上，則事件偵聽程式不會在目前階段觸發，但會在事件流程的後續階段 (例如反昇階段) 中觸發。

如果您在節點正在處理事件的同時將事件偵聽程式從節點中移除，則事件偵聽程式還是會被目前的動作觸發。 一旦移除了事件偵聽程式，就無法再叫用它 (除非您為了日後的處理而再次註冊它)。

參數

請參閱

會將事件傳送到事件流程。 事件目標就是呼叫 dispatchEvent() 方法時所需的 EventDispatcher 物件。

參數

會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 這可讓您判斷 EventDispatcher 物件是否已經改變事件流程階層中事件類型的處理方式。 若要判斷特定事件類型是否已經實際觸發事件偵聽程式，請使用 willTrigger()。

hasEventListener() 與 willTrigger() 之間的差異在於 hasEventListener() 只檢查所屬的物件，而 willTrigger() 則會檢查整個事件流程中 type 參數所指定的事件。

從 LoaderInfo 物件呼叫 hasEventListener() 時，只會考量呼叫者可以存取的偵聽程式。

參數

請參閱

會從 EventDispatcher 物件移除偵聽程式。 如果沒有相符的偵聽程式以 EventDispatcher 物件來註冊，則呼叫此方法不會產生任何作用。

參數

請參閱

檢查此 EventDispatcher 物件是否已註冊為事件偵聽程式，或者此物件的任何祖先已註冊為特定的事件類型。 當特定類型的事件傳送至此 EventDispatcher 物件或其任何後代時，如果事件偵聽程式在事件流程的任何階段觸發，此方法就會傳回 true。

hasEventListener() 與 willTrigger() 方法之間的差異在於 hasEventListener() 只檢查所屬的物件，而 willTrigger() 則會檢查整個事件流程中 type 參數所指定的事件。

從 LoaderInfo 物件呼叫 willTrigger() 時，只會考量呼叫者可以存取的偵聽程式。

參數

當 Flash Player 取得作業系統焦點並成為作用中狀態時傳送。

注意：這個事件不會經歷「捕捉階段」，而且不管目標是否在顯示清單上，都會直接傳送至目標。

這個事件具有下列屬性：

當 Flash Player 失去作業系統焦點並成為停用狀態時傳送。

注意：這個事件不會經歷「捕捉階段」，而且不管目標是否在顯示清單上，都會直接傳送至目標。

這個事件具有下列屬性：

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