Pacchettoflash.events
Classepublic class Event
EreditarietàEvent Inheritance Object
Sottoclassi ActivityEvent, CaptionChangeEvent, CaptionTargetEvent, ColorPickerEvent, ComponentEvent, ContextMenuEvent, DataChangeEvent, FocusEvent, HTTPStatusEvent, KeyboardEvent, LayoutEvent, ListEvent, MetadataEvent, MotionEvent, MouseEvent, NetStatusEvent, ProgressEvent, ScrollEvent, SliderEvent, SoundEvent, StatusEvent, SyncEvent, TextEvent, TimerEvent, TweenEvent, VideoEvent

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Event è utilizzata come classe base per la creazione di oggetti evento, che vengono passati come parametri ai listener di eventi quando si verifica un evento.

Le proprietà della classe Event contengono informazioni di base relative a un evento quali il tipo di evento o la possibilità di annullare il comportamento predefinito dell'evento. Per molti eventi, ad esempio quelli rappresentati dalle costanti della classe Event, queste informazioni di base sono sufficienti. Per altri eventi possono invece essere necessarie informazioni più dettagliate. Per gli eventi associati a un clic del mouse, ad esempio, è necessario includere informazioni aggiuntive sulla posizione dell'evento click e sulla pressione di eventuali tasti durante l'evento click. Queste informazioni aggiuntive possono essere passate ai listener di eventi mediante l'estensione della classe Event, attuata tramite la classe MouseEvent. L'API Flash® Player definisce varie sottoclassi Event per gli eventi comuni che necessitano di informazioni aggiuntive. Gli eventi associati alle varie sottoclassi Event sono descritti nella documentazione relativa alle singole classi.

I metodi della classe Event si possono utilizzare nelle funzioni dei listener di eventi per modificare il comportamento dell'oggetto evento. Ad alcuni eventi è associato un comportamento predefinito. Ad esempio, all'evento doubleClick è associato un comportamento predefinito che evidenzia la parola sotto il puntatore del mouse nel momento in cui si verifica l'evento. Il listener di eventi può annullare questo comportamento chiamando il metodo preventDefault(). È anche possibile fare in modo che il listener di eventi corrente sia l'ultimo a elaborare un evento chiamando il metodo stopPropagation() o stopImmediatePropagation().

Vedere gli esempi

Vedere anche

flash.events.EventDispatcher
Oggetti evento


Proprietà pubbliche
 ProprietàDefinito da
  bubbles: Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
  cancelable: Boolean
[sola lettura] Indica se il comportamento associato all'evento può essere impedito.
Event
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  currentTarget: Object
[sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
Event
  eventPhase: uint
[sola lettura] La fase attuale del flusso di eventi.
Event
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  target: Object
[sola lettura] Il target dell'evento.
Event
  type: String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito da
  
Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false)
Crea un oggetto Event da passare come parametro ai listener di eventi.
Event
  
Duplica un'istanza di una sottoclasse Event.
Event
  
formatToString(className:String, ... arguments):String
Una funzione di utilità per l'implementazione del metodo toString() nella classe Event personalizzata.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
  
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
  
Restituisce una stringa che contiene tutte le proprietà dell'oggetto Event.
Event
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito da
  ACTIVATE: String = "activate"
[statico] Definisce il valore della proprietà type di un oggetto evento activate.
Event
  ADDED: String = "added"
[statico] Definisce il valore della proprietà type di un oggetto evento added.
Event
  ADDED_TO_STAGE: String = "addedToStage"
[statico] Definisce il valore della proprietà type di un oggetto evento addedToStage.
Event
  CANCEL: String = "cancel"
[statico] Definisce il valore della proprietà type di un oggetto evento cancel.
Event
  CHANGE: String = "change"
[statico] Definisce il valore della proprietà type di un oggetto evento change.
Event
  CLOSE: String = "close"
[statico] Definisce il valore della proprietà type di un oggetto evento close.
Event
  COMPLETE: String = "complete"
[statico] Definisce il valore della proprietà type di un oggetto evento complete.
Event
  CONNECT: String = "connect"
[statico] Definisce il valore della proprietà type di un oggetto evento connect.
Event
  DEACTIVATE: String = "deactivate"
[statico] Definisce il valore della proprietà type di un oggetto evento deactivate.
Event
  ENTER_FRAME: String = "enterFrame"
[statico] Definisce il valore della proprietà type di un oggetto evento enterFrame.
Event
  FULLSCREEN: String = "fullScreen"
[statico] Definisce il valore della proprietà type di un oggetto evento fullScreen.
Event
  ID3: String = "id3"
[statico] Definisce il valore della proprietà type di un oggetto evento id3.
Event
  INIT: String = "init"
[statico] Definisce il valore della proprietà type di un oggetto evento init.
Event
  MOUSE_LEAVE: String = "mouseLeave"
[statico] Definisce il valore della proprietà type di un oggetto evento mouseLeave.
Event
  OPEN: String = "open"
[statico] Definisce il valore della proprietà type di un oggetto evento open.
Event
  REMOVED: String = "removed"
[statico] Definisce il valore della proprietà type di un oggetto evento removed.
Event
  REMOVED_FROM_STAGE: String = "removedFromStage"
[statico] Definisce il valore della proprietà type di un oggetto evento removedFromStage.
Event
  RENDER: String = "render"
[statico] Definisce il valore della proprietà type di un oggetto evento render.
Event
  RESIZE: String = "resize"
[statico] Definisce il valore della proprietà type di un oggetto evento resize.
Event
  SCROLL: String = "scroll"
[statico] Definisce il valore della proprietà type di un oggetto evento scroll.
Event
  SELECT: String = "select"
[statico] Definisce il valore della proprietà type di un oggetto evento select.
Event
  SOUND_COMPLETE: String = "soundComplete"
[statico] Definisce il valore della proprietà type di un oggetto evento soundComplete.
Event
  TAB_CHILDREN_CHANGE: String = "tabChildrenChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.
Event
  TAB_ENABLED_CHANGE: String = "tabEnabledChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.
Event
  TAB_INDEX_CHANGE: String = "tabIndexChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabIndexChange.
Event
  UNLOAD: String = "unload"
[statico] Definisce il valore della proprietà type di un oggetto evento unload.
Event
Descrizione delle proprietà
bubblesproprietà
bubbles:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se un evento è un evento di bubbling. Se l'evento può effettuare la propagazione, questo valore è true; in caso contrario è false.

Quando si verifica un evento, passa attraverso le tre fasi del flusso di eventi: la fase di cattura, che procede dall'inizio della gerarchia dell'elenco di visualizzazione al nodo subito prima del nodo target; la fase target, che comprende il nodo target, e la fase di bubbling, che risale dal nodo successivo al nodo target verso l'inizio della gerarchia dell'elenco di visualizzazione.

Alcuni eventi, quali gli eventi activate e unload, non hanno una fase di bubbling. La proprietà bubbles ha un valore false per gli eventi che non hanno una fase di bubbling.


Implementazione
    public function get bubbles():Boolean

Vedere anche

cancelableproprietà 
cancelable:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il comportamento associato all'evento può essere impedito. Se il comportamento può essere annullato, questo valore è true; in caso contrario è false.


Implementazione
    public function get cancelable():Boolean

Vedere anche

currentTargetproprietà 
currentTarget:Object  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. Ad esempio, se un utente fa clic su un pulsante OK, il target corrente potrebbe essere il nodo contenente quel pulsante o uno dei suoi antenati che ha registrato un listener di eventi per quell'evento.


Implementazione
    public function get currentTarget():Object

Vedere anche

eventPhaseproprietà 
eventPhase:uint  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La fase attuale del flusso di eventi. Questa proprietà può contenere i seguenti valori numerici:


Implementazione
    public function get eventPhase():uint

Vedere anche

targetproprietà 
target:Object  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il target dell'evento. Questa proprietà contiene il nodo target. Ad esempio, se un utente fa clic su un pulsante OK, il nodo target è il nodo dell'elenco di visualizzazione che contiene tale pulsante.


Implementazione
    public function get target():Object

Vedere anche

typeproprietà 
type:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il tipo di evento. Il tipo fa distinzione tra maiuscole e minuscole.


Implementazione
    public function get type():String

Vedere anche

Descrizione della funzione di costruzione
Event()Funzione di costruzione
public function Event(type:String, bubbles:Boolean = false, cancelable:Boolean = false)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto Event da passare come parametro ai listener di eventi.

Parametri
type:String — Il tipo di evento, accessibile come Event.type.
 
bubbles:Boolean (default = false) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. Il valore predefinito è false.
 
cancelable:Boolean (default = false) — Determina se l'oggetto Event può essere annullato. Il valore predefinito è false.
Descrizione dei metodi
clone()metodo
public function clone():Event

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Duplica un'istanza di una sottoclasse Event.

Restituisce un nuovo oggetto Event che è una copia dell'istanza originale dell'oggetto Event. Di norma, clone() non viene chiamato; la classe EventDispatcher lo chiama automaticamente quando viene reinviato un evento, ovvero quando si chiama dispatchEvent(event) da un gestore che sta gestendo event.

Il nuovo oggetto Event comprende tutte le proprietà dell'originale.

Quando si crea una classe Event personalizzata è necessario sostituire il metodo Event.clone() ereditato per consentire la duplicazione delle proprietà della classe personalizzata. Se non si impostano tutte le proprietà aggiunte nella sottoclasse Event, queste non avranno valori corretti quando i listener gestiranno l'evento reinviato.

In questo esempio, PingEvent è una sottoclasse di Event e pertanto implementa la sua versione di clone().

  class PingEvent extends Event { var URL:String; public override function clone():Event { return new PingEvent(type, bubbles, cancelable, URL); } }
  

Restituisce
Event — Un nuovo oggetto Event identico all'originale.

Vedere anche

formatToString()metodo 
public function formatToString(className:String, ... arguments):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Una funzione di utilità per l'implementazione del metodo toString() nella classe Event personalizzata. La sostituzione del metodo toString() è consigliata ma non obbligatoria.

  class PingEvent extends Event { var URL:String; public override function toString():String { return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL"); } }
  

Parametri

className:String — Il nome della classe Event personalizzata. Nell'esempio precedente, il parametro className è PingEvent.
 
... arguments — Le proprietà della classe Event e le proprietà aggiunte dall'utente nella classe Event personalizzata. Nell'esempio precedente, il parametro ...arguments comprende type, bubbles, cancelable, eventPhase e URL.

Restituisce
String — Il nome della classe Event personalizzata e il valore di stringa del parametro ...arguments.
isDefaultPrevented()metodo 
public function isDefaultPrevented():Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Verifica se sull'evento è stato chiamato il metodo preventDefault(). Se è stato chiamato preventDefault(), restituisce true; in caso contrario restituisce false.

Restituisce
Boolean — Se è stato chiamato preventDefault(), restituisce true; in caso contrario restituisce false.

Vedere anche

preventDefault()metodo 
public function preventDefault():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.

A molti eventi sono associati comportamenti che Flash Player esegue per impostazione predefinita. Ad esempio, se un utente digita un carattere in un campo di testo, il comportamento predefinito prevede che il carattere sia visualizzato nel campo di testo. Poiché il comportamento predefinito dell'evento TextEvent.TEXT_INPUT può essere annullato, è possibile utilizzare il metodo preventDefault() per impedire la visualizzazione del carattere.

Un esempio di comportamento non annullabile è il comportamento predefinito associato all'evento Event.REMOVED, che viene generato ogni volta che Flash Player sta per rimuovere un oggetto dall'elenco di visualizzazione. Il comportamento predefinito (la rimozione dell'elemento) non può essere annullato e quindi il metodo preventDefault() non ha alcun effetto su questo comportamento predefinito.

Per verificare se è possibile impedire il comportamento predefinito associato a un determinato evento, è possibile utilizzare la proprietà Event.cancelable. Se il valore di Event.cancelable è true, il metodo preventDefault() può essere utilizzato per annullare l'evento; in caso contrario, il metodo preventDefault() non ha alcun effetto.

Vedere anche

stopImmediatePropagation()metodo 
public function stopImmediatePropagation():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. Questo metodo ha effetto immediato e influisce sui listener di eventi del nodo corrente. Al contrario, il metodo stopPropagation() ha effetto solo quando tutti i listener di eventi del nodo corrente hanno terminato l'elaborazione.

Nota: questo metodo non annulla il comportamento associato all'evento. Per informazioni su questa funzionalità, vedere preventDefault().

Vedere anche

stopPropagation()metodo 
public function stopPropagation():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. Questo metodo non influisce sugli eventuali listener di eventi del nodo corrente (currentTarget). Al contrario, il metodo stopImmediatePropagation() impedisce l'elaborazione dei listener di eventi sia nel nodo corrente che in quelli successivi. Le chiamate aggiuntive a questo metodo non hanno alcun effetto. Il metodo può essere chiamato in qualunque fase del flusso di eventi.

Nota: questo metodo non annulla il comportamento associato all'evento. Per informazioni su questa funzionalità, vedere preventDefault().

Vedere anche

toString()metodo 
public function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una stringa che contiene tutte le proprietà dell'oggetto Event. La stringa ha il seguente formato:

[Event type=value bubbles=value cancelable=value]

Restituisce
String — Una stringa che contiene tutte le proprietà dell'oggetto Event.

Vedere anche

Descrizione delle costanti
ACTIVATECostante
public static const ACTIVATE:String = "activate"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento activate.

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à:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetQualsiasi istanza DisplayObject con un listener registrato per l'evento ACTIVATE.

Vedere anche

ADDEDCostante 
public static const ADDED:String = "added"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento added.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'istanza DisplayObject che viene aggiunta all'elenco di visualizzazione. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

ADDED_TO_STAGECostante 
public static const ADDED_TO_STAGE:String = "addedToStage"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Definisce il valore della proprietà type di un oggetto evento addedToStage.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'istanza DisplayObject aggiunta all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'istanza DisplayObject. Se l'istanza DisplayObject viene aggiunta direttamente, l'evento added si verifica prima di questo evento.

Vedere anche

CANCELCostante 
public static const CANCEL:String = "cancel"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento cancel.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetUn riferimento all'oggetto sul quale viene annullata l'operazione.

Vedere anche

CHANGECostante 
public static const CHANGE:String = "change"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento change.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto il cui valore è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

CLOSECostante 
public static const CLOSE:String = "close"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento close.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto la cui connessione è stata chiusa.

Vedere anche

COMPLETECostante 
public static const COMPLETE:String = "complete"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento complete.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto di rete che ha completato il caricamento.

Vedere anche

CONNECTCostante 
public static const CONNECT:String = "connect"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento connect.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Socket o XMLSocket che ha stabilito una connessione di rete.

Vedere anche

DEACTIVATECostante 
public static const DEACTIVATE:String = "deactivate"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento deactivate.

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à:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetQualsiasi istanza DisplayObject con un listener registrato per l'evento DEACTIVATE.

Vedere anche

ENTER_FRAMECostante 
public static const ENTER_FRAME:String = "enterFrame"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento enterFrame.

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à:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetQualsiasi istanza DisplayObject con un listener registrato per l'evento ENTER_FRAME.

Vedere anche

FULLSCREENCostante 
public static const FULLSCREEN:String = "fullScreen"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento fullScreen.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Stage.

Vedere anche

ID3Costante 
public static const ID3:String = "id3"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento id3.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Sound che carica l'MP3 per cui sono ora disponibili dati ID3. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

INITCostante 
public static const INIT:String = "init"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento init.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto LoaderInfo associato al file SWF che viene caricato.

Vedere anche

MOUSE_LEAVECostante 
public static const MOUSE_LEAVE:String = "mouseLeave"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento mouseLeave.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Stage. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

OPENCostante 
public static const OPEN:String = "open"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento open.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto di rete che ha aperto una connessione.

Vedere anche

REMOVEDCostante 
public static const REMOVED:String = "removed"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento removed.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'istanza DisplayObject che deve essere eliminata dall'elenco di visualizzazione. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

REMOVED_FROM_STAGECostante 
public static const REMOVED_FROM_STAGE:String = "removedFromStage"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Definisce il valore della proprietà type di un oggetto evento removedFromStage.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'istanza DisplayObject rimossa dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'istanza DisplayObject. Se l'istanza DisplayObject viene rimossa direttamente, l'evento removed si verifica prima di questo evento.

Vedere anche

RENDERCostante 
public static const RENDER:String = "render"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento render.

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à:

ProprietàValore
bubblesfalse
cancelablefalse; il comportamento predefinito non può essere annullato.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetQualsiasi istanza DisplayObject con un listener registrato per l'evento RENDER.

Vedere anche

RESIZECostante 
public static const RESIZE:String = "resize"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento resize.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Stage.

Vedere anche

SCROLLCostante 
public static const SCROLL:String = "scroll"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento scroll.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto TextField che è stato fatto scorrere. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

SELECTCostante 
public static const SELECT:String = "select"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento select.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto FileReference su cui è stata selezionata una voce.

Vedere anche

SOUND_COMPLETECostante 
public static const SOUND_COMPLETE:String = "soundComplete"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento soundComplete.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Sound su cui è terminata la riproduzione di un suono.

Vedere anche

TAB_CHILDREN_CHANGECostante 
public static const TAB_CHILDREN_CHANGE:String = "tabChildrenChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto il cui flag tabChildren è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

TAB_ENABLED_CHANGECostante 
public static const TAB_ENABLED_CHANGE:String = "tabEnabledChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'istanza InteractiveObject il cui flag tabEnabled è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

TAB_INDEX_CHANGECostante 
public static const TAB_INDEX_CHANGE:String = "tabIndexChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento tabIndexChange.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto il cui tabIndex è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

UNLOADCostante 
public static const UNLOAD:String = "unload"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento unload.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto LoaderInfo associato al file SWF che viene caricato o sostituito.

Vedere anche

Esempi Come utilizzare gli esempi
EventExample.as

Nell'esempio seguente vengono utilizzate la classe EventExample e classe personalizzata Square per mostrare come gestire la fase di bubbling degli eventi.
package {
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.MouseEvent;

    public class EventExample extends Sprite {
        
        public function EventExample() {
            var square_0:Square = new Square(300, 0x336633);
            addChild(square_0);
            
            var square_1:Square = new Square(250, 0x669966);
            square_0.addChild(square_1);

            var square_2:Square = new Square(200, 0x66CC66);
            square_1.addChild(square_2);

            var square_3:Square = new Square(150, 0xAA0000);
            square_3.shouldBubble = false;
            square_2.addChild(square_3);

            var square_4:Square = new Square(100, 0x66FF66);
            square_3.addChild(square_4);

            var square_5:Square = new Square(50, 0xCC0000);
            square_5.shouldBubble = false;
            square_4.addChild(square_5);

            this.addEventListener(MouseEvent.CLICK, clickHandler);
        }
        
        private function clickHandler(e:Event):void {
            trace(">> stage: " + e.type + " event from " + e.target.name + " called on " + this.name);
            trace(">> --------------------------------------------");
        }
    }
}

import flash.display.Sprite;
import flash.events.Event;
import flash.events.MouseEvent;

class Square extends Sprite {
    private var sideLen:int;
    private var color:Number;
    public var shouldBubble:Boolean = true;

    public function Square(sideLen:int, color:Number) {
        this.sideLen = sideLen;
        this.color = color;
        init();
        draw();
    }
        
    private function init():void {
        buttonMode = true;
        this.addEventListener(MouseEvent.CLICK, firstClickHandler);
        this.addEventListener(MouseEvent.CLICK, secondClickHandler);
        this.addEventListener(MouseEvent.CLICK, thirdClickHandler);
    }
        
    private function draw():void {
        this.graphics.beginFill(color);
        this.graphics.drawRect(0, 0, sideLen, sideLen);
    }
        
    private function firstClickHandler(e:Event):void {
        trace(">> 1e: " + e.type + " event from " + e.target.name + " called on " + this.name);
        if(!shouldBubble) {
            e.stopPropagation();
        }
    }

    private function secondClickHandler(e:Event):void {
        trace(">> 2e: " + e.type + " event from " + e.target.name + " called on " + this.name);
        if(!shouldBubble) {
            e.stopImmediatePropagation();
            trace(">> --------------------------------------------");
        }
    }

    private function thirdClickHandler(e:Event):void {
        trace(">> 3e: " + e.type + " event from " + e.target.name + " called on " + this.name);
    }
}
EventExample2.as

Nell'esempio seguente viene creata una dimostrazione interattiva della differenza tra gli eventi ADDED e ADDED_TO_STAGE e della differenza tra gli eventi REMOVED e REMOVED_FROM_STAGE. Se si fa clic su uno sprite, esso verrà rimosso insieme a tutto ciò che è nidificato al suo interno. Ad esempio, se si fa clic sull'oggetto sprite più grande, verrà attivato un evento REMOVED e tre eventi REMOVED_FROM_STAGE.
 package {
    import flash.display.Sprite;
    import flash.events.*;

    public class EventExample2 extends Sprite {
        public function EventExample2():void {
            var parentSprite:Sprite = createSprite("parentSprite",200);
            var childSprite:Sprite = createSprite("childSprite",100);
            var childOfChildSprite:Sprite = createSprite("childOfChildSprite",50);
            
            trace(":: Adding to Stage ::");
            this.addChild(parentSprite);
            trace(":: Adding to Stage ::");
            parentSprite.addChild(childSprite);
            trace(":: Adding to Stage ::");
            childSprite.addChild(childOfChildSprite);
        }
        private function createSprite(name:String,size:uint):Sprite {
            trace(":: Creating Sprite ::");
            var newSprite:Sprite = new Sprite();
            newSprite.name = name;
            newSprite.graphics.beginFill(0xFFFFFF * Math.random(),1);
            newSprite.graphics.drawRect(0,0,size,size);
            newSprite.graphics.endFill();
            newSprite.addEventListener(Event.ADDED, spriteAdded);
            newSprite.addEventListener(Event.ADDED_TO_STAGE, spriteAddedToStage);
            newSprite.addEventListener(Event.REMOVED, spriteRemoved);
            newSprite.addEventListener(Event.REMOVED_FROM_STAGE, spriteRemovedFromStage);
            newSprite.addEventListener(MouseEvent.CLICK, remove);
            return newSprite;
        }
        private function remove(event:Event) {
            if(event.target == event.currentTarget) {
                trace(":: Removing Clicked Sprite ::");
                var target:Sprite = Sprite(event.target);
                target.parent.removeChild(target);
            }
        }
        private function spriteRemovedFromStage(event:Event):void {
            trace("REMOVED_FROM_STAGE: " + event.target.name + " : " + event.currentTarget.name);
        }
        private function spriteRemoved(event:Event):void {
            trace("REMOVED: " + event.target.name + " from " + event.currentTarget.name);
        }
        private function spriteAddedToStage(event:Event):void {
            trace("ADDED_TO_STAGE: " + event.target.name + " : " + event.currentTarget.name);
        }
        private function spriteAdded(event:Event):void {
            trace("ADDED: " + event.target.name + " within " + event.currentTarget.name);
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/events/Event.html