EventDispatcher  - AS3

Agrega uma ocorrência da classe EventDispatcher.

A classe EventDispatcher geralmente é utilizada como uma classe base, o que significa que a a maioria dos desenvolvedores não precisam usar esta função de construtor. No entanto, desenvolvedores avançados que estejam implementado a interface IEventDispatcher precisam utilizar este construtor. Se você não conseguir ampliar a classe EventDispatcher e precisar implementar a interface IEventDispatcher, utilize este construtor para agregar uma ocorrência da classe EventDispatcher.

Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. Você pode registrar ouvintes de eventos em todos os nós da lista de exibição de um tipo específico de evento, fase e prioridade.

Depois de registrar um ouvinte de evento com êxito, não será possível alterar a respectiva prioridade por meio de chamadas adicionais para o addEventListener(). Para alterar a prioridade de um ouvinte, chame primeiramente o removeListener(). Em seguida, você poderá registrar o ouvinte novamente com o novo nível de prioridade.

Tenha em mente que, após o ouvinte ser registrado, chamadas subsequentes para o addEventListener() com um valor type ou useCapture diferente resultarão na criação de um registro de ouvinte separado. Por exemplo, se você primeiro registrar um ouvinte com o useCapture definido como true, ele escutará apenas durante a fase de captura. Se você chamar o addEventListener() novamente, usando o mesmo objeto de ouvinte, mas com o useCapture definido como false, você terá dois ouvintes distintos: um que escuta durante a fase de captura e outro que escuta durante as fases de destino e de bubbling.

Você não pode registrar um ouvinte de evento apenas para a fase de destino ou a fase de bubbling. Essas fases são emparelhadas durante o registro porque o bubbling se aplica apenas aos ancestral do nó-alvo.

Se você não precisar mais de um ouvinte de evento, remova-o, chamando o removeEventListener(); do contrário, poderão ocorrer problemas de memória. Os ouvintes de evento não são retirados automaticamente da memória porque o coletor de lixo não remove o ouvinte enquanto o objeto de despacho existe (a menos que o parâmetro useWeakReference seja definido para true).

Copiar uma ocorrência do EventDispatcher não copia os ouvintes de eventos a ele anexados. (Se o seu recém-criado nó precisar de um ouvinte de evento, anexe o ouvinte após criar o nó). Entretanto, se você mover uma ocorrência do EventDispatcher, os ouvintes de evento anexados se movimentarão com ele.

Se o ouvinte de evento estiver sendo registrado em um nó enquanto um evento estiver sendo processado nesse nó, o ouvinte de evento não será disparado durante a fase atual, mas poderá ser disparado durante uma fase posterior no fluxo de eventos, como a fase de bubbling.

Se um ouvinte de evento for removido de um nó enquanto um evento estiver sendo processado no nó, ele ainda será disparado pelas ações atuais. Depois de removido, o ouvinte de evento nunca mais é chamado novamente (a menos que registrado mais uma vez para processamento futuro).

Parâmetros

function(evt:Event):void

Envia um evento para o fluxo de eventos. O destino de evento é o objeto EventDispatcher no qual o método dispatchEvent() é chamado.

Parâmetros

Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. Isto permite determinar quando um objeto EventDispatcher alterou o tratamento de um tipo de evento na hierarquia de fluxo de eventos. Para determinar se um tipo de evento específico efetivamente dispara um ouvinte de evento, utilize o willTrigger().

A diferença entre o hasEventListener() e o willTrigger() é que o hasEventListener() examina só o objeto a que ele pertence, ao passo que o willTrigger() examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type.

Quando o hasEventListener() é chamado de um objeto LoaderInfo, apenas os ouvintes que o chamador pode acessar são considerados.

Parâmetros

Elementos da API relacionados

Remove um ouvinte do objeto EventDispatcher. Se não existir um ouvinte correspondente registrado com o objeto EventDispatcher, uma chamada para esse método não terá efeito.

Parâmetros

Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. Este método retorna true se um ouvinte de evento for disparado durante qualquer fase do fluxo de eventos quando um evento do tipo especificado for despachado para esse objeto EventDispatcher ou para algum de seus descendentes.

A diferença entre o método hasEventListener() e o willTrigger() é que o hasEventListener() examina só o objeto a que pertence, ao passo que o método willTrigger() examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type.

Quando o willTrigger() é chamado de um objeto LoaderInfo, apenas os ouvintes que o chamador pode acessar são considerados.

Parâmetros

[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. Esse é um evento de transmissão, ou seja, ele é despachado por todos os objetos EventDispatcher com um ouvinte registrado para esse evento. Para obter mais informações sobre eventos de transmissão, consulte a classe DisplayObject.

Observação: Esse evento não tem uma "fase de captura" nem "fase de bubble", significando que os ouvintes de evento precisam ser adicionados diretamente a qualquer destino possível que esteja ou não na lista de exibição.

Dispositivos AIR for TV nunca emitem este evento automaticamente. Você pode, contudo, emiti-lo manualmente.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. Esse é um evento de transmissão, ou seja, ele é despachado por todos os objetos EventDispatcher com um ouvinte registrado para esse evento. Para obter mais informações sobre eventos de transmissão, consulte a classe DisplayObject.

Observação: Esse evento não tem uma "fase de captura" nem "fase de bubble", significando que os ouvintes de evento precisam ser adicionados diretamente a qualquer destino possível que esteja ou não na lista de exibição.

Dispositivos AIR for TV nunca emitem este evento automaticamente. Você pode, contudo, emiti-lo manualmente.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

1. O construtor de EventDispatcherExample cria uma variável local dispatcher e a atribui a uma nova ocorrência CustomDispatcher.
2. Dentro do CustomDispatcher, uma string é definida para que o evento tenha o nome action e o método doAction() é declarado. Quando chamado, este método cria o evento action e o envia por meio do EventDispatcher.dispatchEvent().
3. A propriedade dispatcher é então utilizada para adicionar o ouvinte de evento action e o método de assinante associado actionHandler(), que simplesmente imprime informações sobre o evento quando ele é despachado.
4. O método doAction() é chamado, enviando o 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));
    }
}