Aggrega un'istanza della classe EventDispatcher.

La classe EventDispatcher viene in genere utilizzata come classe base e, pertanto, la maggior parte degli sviluppatori non ha bisogno di utilizzare questa funzione di costruzione. Gli sviluppatori avanzati che implementano l'interfaccia IEventDispatcher devono invece utilizzare questa funzione di costruzione. Se non è possibile estendere la classe EventDispatcher e occorre invece implementare l'interfaccia IEventDispatcher, utilizzare questa funzione di costruzione per aggregare un'istanza della classe EventDispatcher.

Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. È possibile registrare listener di eventi in tutti i nodi dell'elenco di visualizzazione per un tipo di evento, una fase e una priorità specifiche.

Una volta registrato un listener di eventi, non è possibile modificarne la priorità mediante chiamate aggiuntive a addEventListener(). Per modificare la priorità di un listener è necessario chiamare innanzitutto removeListener(). In seguito è possibile registrare nuovamente il listener con il nuovo livello di priorità.

Tenere presente che, dopo la registrazione del listener, le successive chiamate a addEventListener() con un valore type o useCapture diverso determinano la creazione di un'altra registrazione per il listener. Ad esempio, se un listener viene registrato inizialmente con useCapture impostato su true, l'intercettazione avviene solo durante la fase di cattura. Se si chiama di nuovo addEventListener() utilizzando lo stesso oggetto listener ma impostando useCapture su false, si ottengono due listener separati: uno rileva gli eventi durante la fase di cattura e l'altro durante la fasi target e di bubbling.

Non è possibile registrare un listener di eventi solo per la fase target o per la fase di bubbling. Queste fasi vengono accoppiate durante la registrazione perché la propagazione è valida solo per gli antenati del nodo target.

Se il listener di eventi non è più necessario, rimuoverlo con una chiamata a removeEventListener() per evitare problemi di memoria. Gli oggetti con listener di eventi registrati non vengono eliminati automaticamente dalla memoria perché il garbage collector non rimuove gli oggetti ancora dotati di riferimenti.

Se si copia un'istanza EventDispatcher, i listener di eventi associati all'istanza non vengono copiati (se un nodo appena creato necessita di un listener di eventi, è necessario associarlo dopo avere creato il nodo). Se invece si sposta un'istanza EventDispatcher, insieme a questa vengono spostati anche i listener di eventi associati.

Se il listener di eventi viene registrato su un nodo mentre questo sta elaborando un evento, il listener di eventi non viene attivato durante la fase corrente ma può esserlo durante una fase successiva del flusso di eventi, ad esempio la fase di bubbling.

Se un listener di eventi viene rimosso da un nodo mentre questo sta elaborando un evento, il listener continua a essere attivato dalle azioni in corso. Dopo che è stato rimosso, il listener di eventi non viene più richiamato (a meno che non venga registrato nuovamente per elaborazioni future).

Parametri

Vedere anche

Invia un evento nel flusso di eventi. Il target dell'evento è l'oggetto EventDispatcher su cui viene chiamato il metodo dispatchEvent().

Parametri

Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. Questo consente di determinare in quale punto un oggetto EventDispatcher ha alterato la gestione di un tipo di evento nella gerarchia del flusso di eventi. Per determinare se un tipo di evento specifico attiva effettivamente un listener di eventi, utilizzare willTrigger().

La differenza tra hasEventListener() e willTrigger() consiste nel fatto che hasEventListener() esamina solo l'oggetto a cui appartiene, mentre willTrigger() esamina tutto il flusso di eventi relativo all'evento specificato dal parametro type.

Quando hasEventListener() viene chiamato da un oggetto LoaderInfo vengono considerati solo i listener a cui il chiamante può accedere.

Parametri

Vedere anche

Rimuove un listener dall'oggetto EventDispatcher. Se non esiste un listener corrispondente registrato nell'oggetto EventDispatcher, la chiamata a questo metodo non ha alcun effetto.

Parametri

Vedere anche

Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. Questo metodo restituisce true se durante qualsiasi fase del flusso di eventi viene attivato un listener di eventi quando un evento del tipo specificato viene inviato all'oggetto EventDispatcher o a uno qualsiasi dei suoi discendenti.

La differenza tra il metodo hasEventListener() e il metodo willTrigger() consiste nel fatto che hasEventListener() esamina solo l'oggetto a cui appartiene, mentre willTrigger() esamina tutto il flusso di eventi relativo all'evento specificato dal parametro type.

Quando willTrigger() viene chiamato da un oggetto LoaderInfo vengono considerati solo i listener a cui il chiamante può accedere.

Parametri

Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo.

Nota: questo evento non è soggetto a una "fase di cattura" e viene inviato direttamente al target, sia che il target si trovi nell'elenco di visualizzazione o meno.

Questo evento ha le seguenti proprietà:

Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.

Nota: questo evento non è soggetto a una "fase di cattura" e viene inviato direttamente al target, sia che il target si trovi nell'elenco di visualizzazione o meno.

Questo evento ha le seguenti proprietà:

1. La funzione di costruzione di EventDispatcherExample crea una variabile locale dispatcher e la assegna a una nuova istanza CustomDispatcher.
2. All'interno di CustomDispatcher viene impostata una stringa che definisce il nome dell'evento come action e viene dichiarato il metodo doAction(). Quando viene chiamato, questo metodo crea l'evento action e lo invia utilizzando EventDispatcher.dispatchEvent().
3. Viene quindi utilizzata la proprietà dispatcher per aggiungere il listener di eventi action e il metodo subscriber actionHandler() associato, il quale stampa semplicemente le informazioni relative all'evento quando questo viene inviato.
4. Viene quindi richiamato il metodo doAction() che invia l'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));
    }
}