EventDispatcher  - AS3

彙總 EventDispatcher 類別的實體。

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

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

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

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

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

如果您不再需要事件偵聽程式，可以呼叫 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));
    }
}