EventDispatcher  - AS3

Voegt een instantie van de klasse EventDispatcher samen.

De klasse EventDispatcher wordt gewoonlijk als een basisklasse gebruikt. Dat betekent dat de meeste ontwikkelaars deze constructorfunctie niet hoeven te gebruiken. Gevorderde ontwikkelaars die de interface IEventDispatcher implementeren moeten deze constructor gebruiken. Wanneer u de klasse EventDispatcher niet kunt uitbreiden en in plaats daarvan de interface IEventDispatcher moet implementeren, kunt u deze constructor gebruiken om een instantie van de klasse EventDispatcher samen te voegen.

Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. U kunt gebeurtenislisteners registreren op alle knooppunten in het weergaveoverzicht van een specifiek type gebeurtenis, fase of prioriteit.

Nadat het registreren van een gebeurtenislistener is voltooid, kunt u de prioriteit ervan niet wijzigen door extra aanroepen van addEventListener(). Wanneer u de prioriteit van een listener wilt wijzigen, moet u eerst removeListener() aanroepen. U kunt de listener opnieuw registreren met het nieuwe prioriteitsniveau.

Nadat de listener is geregistreerd, resulteren volgende aanroepen van addEventListener() met een andere waarde voor type of useCapture in het maken van een afzonderlijke listenerregistratie. Wanneer u bijvoorbeeld eerst een listener registreert bij useCapture ingesteld op true, luistert deze alleen tijdens de vastlegfase. Wanneer u addEventListener() opnieuw aanroept met hetzelfde listenerobject maar met useCapture ingesteld op false, hebt u twee afzonderlijke listeners: één die tijdens de vastlegfase luistert en één die tijdens de doel- en terugkoppelfasen luistert.

U kunt geen gebeurtenislistener registeren voor alleen de doel- of terugkoppelfase. Deze fasen worden bij de registratie gekoppeld, omdat terugkoppeling alleen van toepassing is op voorouders van het doelknooppunt.

Wanneer u een gebeurtenislistener niet langer nodig hebt, kunt u deze verwijderen door removeEventListener() aan te roepen; anders kan dit resulteren in geheugenproblemen. Gebeurtenisluisteraars worden niet automatisch uit het geheugen verwijderd, omdat de verzamelaar met ongewenste details de luisteraar niet verwijderd zolang het verzendende object bestaat (behalve als de parameter useWeakReference op true is ingesteld).

Het kopiëren van een instantie EventDispatcher kopieert de daaraan gekoppelde gebeurtenislisteners. (Wanneer uw nieuwe knooppunt een gebeurtenislistener nodig heeft, moet u de listener eraan koppelen na het maken van het knooppunt.) Wanneer u echter een instantie EventDispatcher verplaatst, worden de daaraan gekoppelde listeners mee verplaatst.

Wanneer de gebeurtenislistener wordt geregistreerd op een knooppunt terwijl een gebeurtenis op dit knooppunt wordt verwerkt, wordt de gebeurtenislistener niet geactiveerd tijdens de huidige fase maar kan wel worden geactiveerd in een latere fase in de gebeurtenisstroom, zoals de terugkoppelfase.

Wanneer een gebeurtenislistener wordt verwijderd uit een knooppunt terwijl een gebeurtenis wordt verwerkt op het knooppunt, wordt deze nog steeds geactiveerd door de huidige handelingen. Nadat deze is verwijderd, wordt de gebeurtenislistener niet meer aangeroepen (tenzij deze opnieuw wordt geregistreerd voor toekomstige verwerking).

Parameters

function(evt:Event):void

Verzendt een gebeurtenis naar de gebeurtenisstroom. Het doel van de gebeurtenis is het object EventDispatcher waar de methode dispatchEvent() op wordt aangeroepen.

Parameters

Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. Op die manier kunt u bepalen waar een object EventDispatcher het afhandelen van een gebeurtenis in de hiërarchie van de gebeurtenisstroom heeft gewijzigd. Wanneer u wilt bepalen of een specifiek gebeurtenistype daadwerkelijk een gebeurtenislistener activeert, kunt u willTrigger() gebruiken.

Het verschil tussen hasEventListener() en willTrigger() is dat hasEventListener() alleen het object controleert waar het toe behoort, terwijl willTrigger() de gehele gebeurtenisstroom controleert voor de gebeurtenis die is opgegeven door de parameter type.

Wanneer hasEventListener() wordt aangeroepen door een object LoaderInfo, wordt alleen rekening gehouden met de listeners waartoe de aanroeper toegang heeft.

Parameters

Verwante API-elementen

Verwijdert een listener uit het object EventDispatcher. Wanneer geen overeenkomende listener is geregistreerd bij het object EventDispatcher, heeft een aanroep van deze methode geen invloed.

Parameters

Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. Deze methode retourneert true wanneer een gebeurtenislistener wordt geactiveerd tijdens een willekeurige fase van de gebeurtenisstroom wanneer een gebeurtenis van het opgegeven type wordt verzonden naar dit object EventDispatcher of een van de afstammingen.

Het verschil tussen hasEventListener() en willTrigger() is dat hasEventListener() alleen het object controleert waar het toe behoort, terwijl willTrigger() de gehele gebeurtenisstroom controleert voor de gebeurtenis die is opgegeven door de parameter type.

Wanneer willTrigger() wordt aangeroepen door een object LoaderInfo, wordt alleen rekening gehouden met de listeners waartoe de aanroeper toegang heeft.

Parameters

[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. Deze gebeurtenis is een uitzendgebeurtenis, wat betekent dat deze wordt verzonden door alle objecten EventDispatcher met een listener die is ingesteld voor deze gebeurtenis. Zie de klasse DisplayObject voor meer informatie over uitzendgebeurtenissen.

Opmerking: Deze gebeurtenis heeft geen 'vastlegfase' en geen 'bubbelfase', wat betekent dat gebeurtenislisteners rechtstreeks aan mogelijke doelen moeten worden toegevoegd, ongeacht of het doel voorkomt in de weergavelijst.

Deze gebeurtenis wordt nooit automatisch verzonden door AIR for TV. U kunt de gebeurtenis wel handmatig verzenden.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. Deze gebeurtenis is een uitzendgebeurtenis, wat betekent dat deze wordt verzonden door alle objecten EventDispatcher met een listener die is ingesteld voor deze gebeurtenis. Zie de klasse DisplayObject voor meer informatie over uitzendgebeurtenissen.

Opmerking: Deze gebeurtenis heeft geen 'vastlegfase' en geen 'bubbelfase', wat betekent dat gebeurtenislisteners rechtstreeks aan mogelijke doelen moeten worden toegevoegd, ongeacht of het doel voorkomt in de weergavelijst.

Deze gebeurtenis wordt nooit automatisch verzonden door AIR for TV. U kunt de gebeurtenis wel handmatig verzenden.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

1. De constructor van EventDispatcherExample maakt een lokale variabele dispatcher en wijst deze toe aan een nieuwe instantie CustomDispatcher.
2. Binnen CustomDispatcher wordt een tekenreeks ingesteld, zodat de gebeurtenis de naam action krijgt en de methode doAction() wordt gedeclareerd. Wanneer deze wordt aangeroepen, maakt de methode de gebeurtenis action en verzendt het verzendt deze met behulp van EventDispatcher.dispatchEvent().
3. De eigenschap dispatcher wordt vervolgens gebruikt om de gebeurtenislistener action en de daaraan gekoppelde abonneemethode actionHandler() toe te voegen, die informatie over de gebeurtenis afdrukt wanneer deze wordt verzonden.
4. De methode doAction() wordt aangeroepen, die de gebeurtenis action verzendt.

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