DataEvent

Pacchetto	flash.events
Classe	public class DataEvent
Ereditarietà	DataEvent TextEvent Event Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Un oggetto invia un oggetto DataEvent al termine del caricamento di dati originari. Esistono due tipi di eventi Data:

DataEvent.DATA: inviato dopo che sono stati inviati o ricevuti dei dati.
DataEvent.UPLOAD_COMPLETE_DATA: inviato quando sono stati inviati dei dati e il server ha risposto.

Vedere gli esempi

Elementi API correlati

flash.net.FileReference
flash.net.XMLSocket

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	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
		constructor : 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
		data : String I dati originari caricati in Flash Player o Adobe AIR.	DataEvent
		eventPhase : uint [sola lettura] La fase attuale del flusso di eventi.	Event
		target : Object [sola lettura] Il target dell'evento.	Event
		text : String Per un evento textInput, il carattere o la sequenza di caratteri immessi dall'utente.	TextEvent
		type : String [sola lettura] Il tipo di evento.	Event

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "") Crea un oggetto evento contenente informazioni relative agli eventi di dati.	DataEvent
		clone():Event [override] Crea una copia dell'oggetto DataEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.	DataEvent
		formatToString(className:String, ... arguments):String Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate.	Event
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isDefaultPrevented():Boolean Verifica se sull'evento è stato chiamato il metodo preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		preventDefault():void Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.	Event
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		stopImmediatePropagation():void Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.	Event
		stopPropagation():void Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.	Event
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String [override] Restituisce una stringa che contiene tutte le proprietà dell'oggetto DataEvent.	DataEvent
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

Nascondi costanti pubbliche ereditate

Mostra costanti pubbliche ereditate

	Costante		Definito da
		DATA : String = "data" [statico] Definisce il valore della proprietà type di un oggetto evento Data.	DataEvent
		UPLOAD_COMPLETE_DATA : String = "uploadCompleteData" [statico] Definisce il valore della proprietà type di un oggetto evento uploadCompleteData.	DataEvent

Descrizione delle proprietà

data

proprietà

data:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

I dati originari caricati in Flash Player o Adobe AIR.

Implementazione
public function get data():String
public function set data(value:String):void

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "")

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un oggetto evento contenente informazioni relative agli eventi di dati. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Parametri

	`type:String` — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata `type`. Esiste un solo tipo di evento di dati: `DataEvent.DATA`.

	`bubbles:Boolean` (default = `false`) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata `bubbles`.

	`cancelable:Boolean` (default = `false`) — Determina se l'oggetto Event può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata `cancelable`.

	`data:String` (default = "") — I dati originari caricati in Flash Player o Adobe AIR. I listener di eventi possono accedere a queste informazioni tramite la proprietà `data`.

Elementi API correlati

flash.net.XMLSocket
DataEvent.DATA

Descrizione dei metodi

clone

()

metodo

override public function clone():Event

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea una copia dell'oggetto DataEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce

Event — Un nuovo oggetto DataEvent con proprietà dai valori identici a quelli dell'originale.

toString

()

metodo

override public function toString():String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

[DataEvent type=valore bubbles=valore cancelable=valore data=valore]

Restituisce

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

Descrizione delle costanti

DATA

Costante

public static const DATA:String = "data"

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`data`	I dati originari caricati in Flash Player o Adobe AIR.
`target`	L'oggetto XMLSocket che riceve i dati.

Elementi API correlati

flash.net.XMLSocket.data

UPLOAD_COMPLETE_DATA

Costante

public static const UPLOAD_COMPLETE_DATA:String = "uploadCompleteData"

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4

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

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`data`	I dati originari restituiti dal server in risposta all'esito positivo del caricamento.
`target`	L'oggetto FileReference che riceve i dati a seguito dell'esito positivo del caricamento.

Elementi API correlati

flash.net.FileReference.uploadCompleteData

Esempi Come utilizzare questo esempio

DataEventExample.as

Nell'esempio seguente viene illustrato come creare un oggetto XMLSocket e connetterlo a un server socket in esecuzione sulla porta 8080 di yourDomain. Un listener di eventi è associato all'oggetto XMLSocket che intercetta gli eventi data, i quali vengono inviati ogni volta che vengono ricevuti dati originari.

Note:

Per generare un evento securityError in questo esempio, dovete compilare il file SWF con l'opzione "Sicurezza riproduzione locale" impostato su "Accedi solo alla rete".
È necessario un server in esecuzione su [yourDomain] che utilizza la porta 8080.

package {
    import flash.display.Sprite;
    import flash.events.DataEvent;
    import flash.net.XMLSocket;

    public class DataEventExample extends Sprite {
        private var hostName:String = "[yourDomain]";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function DataEventExample() {
            socket = new XMLSocket();
            socket.addEventListener(DataEvent.DATA, dataHandler);
            socket.connect(hostName, port);
        }

        private function dataHandler(event:DataEvent):void {
            trace("dataHandler: " + event.data);
        }
    }
}

Note legali | Informativa sulla privacy online

DataEvent - AS3

Classi x

data

DataEvent

clone

toString

DATA

UPLOAD_COMPLETE_DATA