Regroupe une occurrence de la classe EventDispatcher.

La classe EventDispatcher est généralement utilisée comme classe de base, ce qui signifie que la plupart des développeurs n’ont pas besoin d’utiliser cette fonction constructeur. Toutefois, les développeurs expérimentés qui implémentent l’interface IEventDispatcher doivent l’utiliser. S'il vous est impossible d’étendre la classe EventDispatcher et que vous devez implémenter l’interface IEventDispatcher à la place, utilisez cette fonction constructeur pour regrouper une occurrence de la classe EventDispatcher.

Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. Vous pouvez enregistrer les écouteurs d’événement dans tous les nœuds de la liste d’affichage pour un type spécifique d’événement, de phase et de priorité.

Après l'enregistrement d'un écouteur d’événements, vous ne pouvez plus modifier sa priorité par d'autres appels de addEventListener(). Pour modifier la priorité d'un écouteur, vous devez d’abord appeler removeListener(). Vous pouvez ensuite réenregistrer l’écouteur avec le nouveau niveau de priorité.

N'oubliez pas qu’une fois l’écouteur enregistré, tous les prochains appels de addEventListener() avec une valeur type ou useCapture différente entraîneront la création d’un autre enregistrement d’écouteur. Si, par exemple, vous enregistrez un écouteur dans lequel la propriété useCapture est définie sur true, il écoute uniquement pendant la phase de capture. Si vous appelez addEventListener() à l’aide du même objet écouteur, mais en définissant useCapture sur false, vous obtenez deux écouteurs distincts : l'un qui écoute pendant la phase de capture et l’autre qui écoute pendant les phases cible et de propagation vers le haut (bubbling).

Il est impossible d’enregistrer un écouteur d’événement pour la phase cible ou la phase de propagation vers le haut (bubbling) uniquement. Ces deux phases sont associées pendant l’enregistrement car la propagation vers le haut (bubbling) s’applique uniquement aux ancêtres du nœud cible.

Si vous n’avez plus besoin d'un écouteur d’événements, supprimez-le en appelant removeEventListener(), afin d'éviter tout problème de mémoire. Les objets associés à des écouteurs d'événements enregistrés ne sont pas automatiquement supprimés de la mémoire, car le nettoyeur de mémoire n’efface pas les objets auxquels il est toujours fait référence.

Lors de la copie d’une occurrence d'EventDispatcher, les écouteurs d’événement qui lui sont associés ne sont pas pris en compte. (Si votre nouveau nœud a besoin d'un écouteur d’événements, vous devez associer celui-ci après la création du nœud). Toutefois, si vous déplacez une occurrence d'EventDispatcher, les écouteurs d’événement qui lui sont associés la suivent.

Si un écouteur d’événement est enregistré sur un nœud alors qu'un événement est en cours de traitement sur ce nœud, l’écouteur n’est pas déclenché pendant la phase actuelle, mais il peut l’être pendant une phase ultérieure du flux d’événements, telle que la phase de propagation vers le haut (bubbling).

Si un écouteur d’événement est supprimé d’un nœud sur lequel un événement est en cours de traitement, il est cependant déclenché par les actions en cours. Une fois supprimé, l’écouteur d’événement n’est plus jamais appelé (à moins d’être réenregistré à des fins de traitement ultérieur).

Paramètres

Voir aussi

Distribue un événement dans le flux d’événements. La cible de l'événement est l'objet EventDispatcher sur lequel la méthode dispatchEvent() est appelée.

Paramètres

Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d’événement. Vous pouvez ainsi déterminer l’emplacement auquel un objet EventDispatcher a modifié la gestion d'un type d'événement dans la hiérarchie du flux d’événements. Pour savoir si un type d’événement spécifique déclenche réellement un écouteur d’événements, utilisez willTrigger().

La différence entre les méthodes hasEventListener() et willTrigger() est la suivante : hasEventListener() examine uniquement l’objet auquel elle appartient, tandis que willTrigger() recherche dans la totalité du flux d’événements l'événement spécifié par le paramètre type.

Lorsque hasEventListener() est appelé à partir d’un objet LoaderInfo, seuls les écouteurs auxquels l’appelant a accès sont pris en compte.

Paramètres

Voir aussi

Supprime un écouteur de l’objet EventDispatcher. Si aucun écouteur correspondant n'est enregistré auprès de l'objet EventDispatcher, appeler cette méthode n’a aucun effet.

Paramètres

Voir aussi

Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. Cette méthode renvoie true si un écouteur d’événement est déclenché pendant toute phase du flux d’événements lorsqu’un événement du type spécifié est distribué à cet objet EventDispatcher ou à l’un de ses descendants.

La différence entre les méthodes hasEventListener() et willTrigger() est la suivante : hasEventListener() examine uniquement l’objet auquel elle appartient, tandis que willTrigger() recherche dans la totalité du flux d’événements celui qui est spécifié par le paramètre type.

Lorsque willTrigger() est appelée à partir d’un objet LoaderInfo, seuls les écouteurs auxquels l’appelant a accès sont pris en compte.

Paramètres

Distribué lorsque Flash Player a le focus du système d’exploitation et devient actif.

Remarque : cet événement ne passe pas par une « phase de capture » et est distribué directement à la cible, que cette dernière soit dans la liste d'affichage ou non.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque Flash Player perd le focus du système d’exploitation et devient inactif.

Remarque : cet événement ne passe pas par une « phase de capture » et est distribué directement à la cible, que cette dernière soit dans la liste d'affichage ou non.

Les propriétés de cet événement sont les suivantes :

1. Le constructeur de EventDispatcherExample crée une variable locale dispatcher et l'affecte à une nouvelle occurrence de CustomDispatcher.
2. A l'intérieur de CustomDispatcher, une chaîne est définie de sorte que l'événement présente le nom action et la méthode doAction() est déclarée. Lorsqu'elle est appelée, cette méthode crée l'événement action et le distribue à l'aide de EventDispatcher.dispatchEvent().
3. La propriété dispatcher est alors utilisée pour ajouter l'écouteur d'événements action et la méthode d'abonné associée actionHandler(), qui imprime simplement les informations relatives à l'événement lorsque qu'il est distribué.
4. La méthode doAction() est invoquée et distribue l'événement 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));
    }
}