EventDispatcher  - AS3

Sammanställer en instans av klassen EventDispatcher.

Klassen EventDispatcher används normalt som en basklass, vilket innebär att de flesta utvecklare inte behöver använda den här konstruktorfunktionen. Avancerade utvecklare som implementerar IEventDispatcher-gränssnittet behöver däremot använda den här konstruktorn. Om du inte kan utöka EventDispatcher-klassen utan istället måste implementera IEventDispatcher-gränssnittet, kan du använda den här konstruktorn för att sammanställa en instans av EventDispatcher-klassen.

Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. Du kan registrera händelseavlyssnare på alla noder i visningslistan efter en särskild typ av händelse, fas och prioritet.

När du har registrerat en händelseavlyssnare går det inte att ändra dess prioritet genom ytterligare anrop till addEventListener(). För att kunna ändra avlyssnarens prioritet måste du först anropa removeListener(). Sedan går det att registrera avlyssnaren på nytt med den nya prioritetsnivån.

Kom ihåg att när avlyssnaren har registrerats så skapar anrop till addEventListener() med annan type eller useCapture-värde en separat avlyssnarregistrering. Om du till exempel först registrerar en avlyssnare med useCapture inställt på true, avlyssnar den bara under hämtningsfasen. Om du anropar addEventListener() igen med samma avlyssningsobjekt men med useCapture inställt på false, får du två separata avlyssnare: en som avlyssnar under hämtningsfasen och en som avlyssnar under både mål- och bubblingsfasen.

Det går inte att registrera en händelseavlyssnare endast för målfasen eller bubblingsfasen. De faserna är sammankopplade vid registreringen eftersom bubblande bara tillämpas på de som är överordnade målnoden.

Om du inte längre behöver en händelseavlyssnare tar du bort den genom att anropa removeEventListener(). Annars finns risk för minnesproblem. Händelseavlyssnare tas inte automatiskt bort från minnet, eftersom skräpinsamlaren inte tar bort avlyssnaren så länge det skickande objektet finns (om inte parametern useWeakReference är true).

Kopiering av en EventDispatcher-instans innebär inte att de händelseavlyssnare som är kopplade till den kopieras. (Om en nod som du nyss skapat behöver en händelseavlyssnare måste du koppla avlyssnaren efter att du skapat noden.) Om du däremot flyttar en EventDispatcher-instans flyttas den kopplade händelseavlyssnaren med.

Om händelseavlyssnaren är registrerad på en nod samtidigt som en händelse bearbetas på den noden aktiveras inte händelseavlyssnaren under den aktuella fasen, men den kan aktiveras under en senare fas i händelseflödet, t.ex. bubblingsfasen.

Om en händelseavlyssnare tas bort från en nod samtidigt som en händelse bearbetas på den noden, aktiveras den ändå av de aktuella åtgärderna. När händelseavlyssnaren tagits bort anropas den aldrig mer (om den inte registreras på nytt för framtida bearbetning).

Parametrar

function(evt:Event):void

Skickar en händelse till händelseflödet. Händelsemålet är det EventDispatcher-objekt som dispatchEvent()-metoden anropas till.

Parametrar

Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. Då kan du bestämma var i händelseflödeshierarkin ett EventDispatcher-objekt har förändrat hanteringen av en händelsetyp. Använd willTrigger() om du vill ta reda på om en viss händelsetyp faktiskt aktiverar en händelseavlyssnare.

Skillnaden mellan hasEventListener() och willTrigger() är att hasEventListener() bara undersöker det objekt som det hör till, medan willTrigger() undersöker hela händelseflödet för händelsen som angetts av type-parametern.

När hasEventListener() anropas från ett LoaderInfo-objekt beaktas bara de avlyssnare som anroparen kan komma åt.

Parametrar

Relaterade API-element

Tar bort en avlyssnare från EventDispatcher-objektet. Ett anrop till den här metoden har ingen effekt om det inte finns någon matchande avlyssnare registrerad för EventDispatcher-objektet.

Parametrar

Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. Den här metoden returnerar true om en händelsavlyssnare aktiveras under någon av faserna i händelseflödet när en händelse av den angivna typen skickas till det här EventDispatcher-objektet eller någon av dess underordnade.

Skillnaden mellan metoderna hasEventListener() och willTrigger() är att hasEventListener() bara undersöker det objekt som det hör till, medan willTrigger()-metoden undersöker hela händelseflödet för händelsen som angetts av type-parametern.

När willTrigger() anropas från ett LoaderInfo-objekt beaktas bara de avlyssnare som anroparen kan komma åt.

Parametrar

[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. Den här händelsen är en utsändningshändelse, vilket innebär att den skickas av alla EventDispatcher-objekt med en avlyssnare registrerad för den här händelsen. Mer information om utsändningshändelser finns i klassen DisplayObject.

Obs! Den här händelsen har varken en ”capture phase” eller en ”bubble phase” vilket innebär att händelseavlyssnaren måste läggas till direkt i potentiella mål, oavsett om målet visas i listan eller inte.

Enheter med AIR for TV skickar aldrig den här händelsen automatiskt. Du kan skicka den manuellt om du vill.

Den här händelsen har följande egenskaper:

Relaterade API-element

[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. Den här händelsen är en utsändningshändelse, vilket innebär att den skickas av alla EventDispatcher-objekt med en avlyssnare registrerad för den här händelsen. Mer information om utsändningshändelser finns i klassen DisplayObject.

Obs! Den här händelsen har varken en ”capture phase” eller en ”bubble phase” vilket innebär att händelseavlyssnaren måste läggas till direkt i potentiella mål, oavsett om målet visas i listan eller inte.

Enheter med AIR for TV skickar aldrig den här händelsen automatiskt. Du kan skicka den manuellt om du vill.

Den här händelsen har följande egenskaper:

Relaterade API-element

1. Konstruktorn av EventDispatcherExample skapar en lokal variabel dispatcher och skickar den till en ny CustomDispatcher-instans.
2. Inuti CustomDispatcher ställs en sträng in så att händelsen får namnet action och doAction()-metoden deklareras. När den anropas skapar den här metoden händelsen action och skickar den med EventDispatcher.dispatchEvent().
3. Egenskapen dispatcher används sedan för att lägga till action-händelseavlyssnaren och den associerade mottagarmetoden actionHandler() som enkelt skriver ut information om händelsen när den skickas.
4. Metoden doAction() anropas och action-händelsen skickas.

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