EventDispatcher  - AS3

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, utilizzate 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. Potete 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 potete modificarne la priorità mediante chiamate aggiuntive a addEventListener(). Per modificare la priorità di un listener dovete chiamare innanzitutto removeListener(). In seguito potete registrare nuovamente il listener con il nuovo livello di priorità.

Tenete 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 registrate un listener inizialmente con useCapture impostato su true, l'intercettazione avviene solo durante la fase di cattura. Se chiamate di nuovo addEventListener() utilizzando lo stesso oggetto listener ma impostando useCapture su false, ottenete due listener separati: uno rileva gli eventi durante la fase di cattura e l'altro durante la fasi target e di bubbling.

Non potete 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, rimovetelo con una chiamata a removeEventListener() per evitare problemi di memoria. I listener di eventi non vengono eliminati automaticamente dalla memoria perché il garbage collector non rimuove il listener fintantoché esiste l'oggetto che effettua l'invio (a meno che il parametro useWeakReference non sia impostato su true).

Se copiate un'istanza EventDispatcher, i listener di eventi associati all'istanza non vengono copiati (se un nodo appena creato necessita di un listener di eventi, dovete associarlo dopo avere creato il nodo). Se invece spostate 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

function(evt:Event):void

Altre informazioni

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, utilizzate 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

Elementi API correlati

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

Altre informazioni

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

[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. Questo è un evento di trasmissione e ciò significa che viene inviato da tutti gli oggetti EventDispatcher con un listener registrato per questo evento. Per ulteriori informazioni sugli eventi di trasmissione, vedete la classe DisplayObject.

Nota: questo evento non dispone di una "fase di cattura" né di una "fase di bubbling"; ciò significa che i listener di eventi devono essere aggiunti direttamente a qualsiasi target potenziale, sia che il target si trovi o meno nell'elenco di visualizzazione.

I dispositivi AIR per TV non inviano mai automaticamente questo evento. È possibile, tuttavia, inviarlo manualmente.

Questo evento ha le seguenti proprietà:

Elementi API correlati

[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. Questo è un evento di trasmissione e ciò significa che viene inviato da tutti gli oggetti EventDispatcher con un listener registrato per questo evento. Per ulteriori informazioni sugli eventi di trasmissione, vedete la classe DisplayObject.

Nota: questo evento non dispone di una "fase di cattura" né di una "fase di bubbling"; ciò significa che i listener di eventi devono essere aggiunti direttamente a qualsiasi target potenziale, sia che il target si trovi o meno nell'elenco di visualizzazione.

I dispositivi AIR per TV non inviano mai automaticamente questo evento. È possibile, tuttavia, inviarlo manualmente.

Questo evento ha le seguenti proprietà:

Elementi API correlati

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