EventDispatcher  - AS3

Agrega una instancia de la clase EventDispatcher.

La clase EventDispatcher suele utilizarse como una clase base, lo que significa que la mayoría de los desarrolladores no necesitan utilizar esta función de constructor. Sin embargo, los desarrolladores avanzados que implementen la interfaz IEventDispatcher necesitarán utilizar este constructor. Si no puede ampliar la clase EventDispatcher y debe implementar la interfaz IEventDispatcher en su lugar, utilice este constructor para agregar una instancia de la clase EventDispatcher.

Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. Puede registrar detectores de eventos en todos los nodos de la lista de visualización para un tipo concreto de evento, fase y prioridad.

Una vez registrado correctamente un detector de eventos, no puede cambiar su prioridad mediante llamadas adicionales a addEventListener(). Para cambiar la prioridad de un detector, en primer lugar debe llamar a removeListener(). Seguidamente, puede volver a registrar el nuevo nivel de prioridad.

Recuerde que, una vez registrado el detector, las siguientes llamadas a addEventListener() con un valor type o useCapture distinto tendrán como resultado la creación de un registro independiente del detector. Por ejemplo, si registra primero un detector con useCapture definido como true, detectará únicamente durante la fase de captura. Si vuelve a llamar a addEventListener() con el mismo objeto detector, pero con useCapture definido como false, tendrá dos detectores independientes: uno que detecta durante la fase de captura y otro que lo hace durante las fases de destino y de propagación.

No es posible registrar un detector de eventos únicamente para la fase de destino o la fase de propagación. Dichas fases se acoplan durante el registro, ya que la propagación sólo se aplica a los ascendientes del nodo de destino.

Si ya no necesita ningún detector de eventos, elimínelo llamando a removeEventListener(); de lo contrario, podrían surgir problemas de memoria. Los detectores de eventos no se eliminan automáticamente de la memoria, ya que el recolector de datos innecesarios no elimina el detector siempre que el objeto distribuido exista (a no ser que el parámetro useWeakReference se establezca en true).

Al copiar una instancia EventDispatcher no se copian los detectores de eventos asociados. (Si el nodo recién creado necesita un detector de eventos, debe asociarlo después de crear el nodo.) Sin embargo, si mueve una instancia EventDispatcher, los detectores de eventos asociados se moverán también.

Si el detector de eventos se registra en un nodo mientras se procesa un evento en dicho nodo, el detector de eventos no se desencadenará durante la fase actual, aunque sí se desencadenará en una fase posterior del flujo del evento, por ejemplo, en la fase de propagación.

Si un detector de eventos se elimina de un nodo mientras se procesa un evento en dicho nodo, las acciones actual seguirán desencadenándolo. Una vez eliminado, el detector de eventos ya no se vuelve a invocar nunca más (a no ser que se registre de nuevo para otro proceso).

Parámetros

function(evt:Event):void

Distribuye un evento en el flujo del evento. El destino del evento es el objeto EventDispatcher en el que se llama al método dispatchEvent().

Parámetros

Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. De este modo, es posible determinar en qué lugar de la jerarquía del flujo del evento un objeto EventDispatcher ha alterado el control de un tipo de evento. Para determinar si un tipo de evento concreto realmente desencadena un detector de eventos, utilice willTrigger().

La diferencia entre hasEventListener() y willTrigger() reside en que hasEventListener() examina sólo el objeto al que pertenece, mientras que willTrigger() examina todo el flujo del evento especificado por el parámetro type.

Si se llama a hasEventListener() desde un objeto LoaderInfo, sólo se tendrán en cuenta los detectores a los que puede acceder el que origina la llamada.

Parámetros

Elementos de API relacionados

Elimina un detector del objeto EventDispatcher. Si no hay ningún detector coincidente registrado con el objeto EventDispatcher, la llamada a este método no surtirá ningún efecto.

Parámetros

Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. Este método devuelve true si se desencadena un detector de eventos durante cualquier fase del flujo del evento cuando se distribuye un evento del tipo especificado a este objeto EventDispatcher o a cualquiera de sus descendientes.

La diferencia entre los métodos hasEventListener() y willTrigger() reside en que hasEventListener() examina sólo el objeto al que pertenece, mientras que el método willTrigger() examina todo el flujo del evento especificado por el parámetro type.

Si se llama a willTrigger() desde un objeto LoaderInfo, sólo se tendrán en cuenta los detectores a los que puede acceder la función que origina la llamada.

Parámetros

[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. Este evento es un evento de difusión, lo que significa que lo distribuyen todos los objetos EventDispatcher con un detector registrado para este evento. Para obtener más información sobre los eventos de difusión, consulte la clase DisplayObject.

Nota: este evento no tiene ni "fase de captura" ni "fase de propagación", lo que significa que los detectores de eventos deben añadirse directamente a cualquier destino potencial, se encuentre o no en la lista de visualización.

Los dispositivos de AIR para TV nunca distribuyen automáticamente este evento. El usuario puede, sin embargo, distribuirlo manualmente.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar inactivos. Este evento es un evento de difusión, lo que significa que lo distribuyen todos los objetos EventDispatcher con un detector registrado para este evento. Para obtener más información sobre los eventos de difusión, consulte la clase DisplayObject.

Nota: este evento no tiene ni "fase de captura" ni "fase de propagación", lo que significa que los detectores de eventos deben añadirse directamente a cualquier destino potencial, se encuentre o no en la lista de visualización.

Los dispositivos de AIR para TV nunca distribuyen automáticamente este evento. El usuario puede, sin embargo, distribuirlo manualmente.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

1. El constructor de EventDispatcherExample crea una variable local dispatcher y la asigna a una nueva instancia de CustomDispatcher.
2. Dentro de CustomDispatcher se define un cadena para que el evento se llame action y se declara el método doAction(). Cuando se llama, este método crea el evento action y lo distribuye utilizando EventDispatcher.dispatchEvent().
3. La propiedad dispatcher se utiliza para añadir el detector de eventos action y un método suscriptor asociado actionHandler(), que simplemente imprime la información sobre el evento cuando se distribuye.
4. Se invoca el método doAction(), que distribuye el evento 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));
    }
}