Pacchetto | flash.events |
Classe | public class ErrorEvent |
Ereditarietà | ErrorEvent ![]() ![]() ![]() |
Sottoclassi | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
La classe ErrorEvent definisce solo un tipo di evento error
: ErrorEvent.ERROR
. La classe ErrorEvent funge anche da classe di base per diverse altre classi di eventi di errore, incluse le classi AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent e UncaughtErrorEvent.
Potete verificare la presenza di eventi error
privi di listener registrando un listener per l'evento uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR).
Un evento non rilevato causa inoltre la visualizzazione di una finestra di dialogo di errore, contenente l'evento di errore, quando il contenuto viene eseguito nella versione di debug di Flash Player o nell'applicazione AIR Debug Launcher (ADL).
Elementi API correlati
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 | |
errorID : int [sola lettura]
Contiene il numero di riferimento associato all'errore specifico. | ErrorEvent | ||
![]() | 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 |
Metodo | Definito da | ||
---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Crea un oggetto Event contenente informazioni relative agli eventi di errore. | ErrorEvent | ||
[override]
Crea una copia dell'oggetto ErrorEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale. | ErrorEvent | ||
![]() |
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | |
![]() |
Indica se per un oggetto è definita una proprietà specifica. | Object | |
![]() |
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | |
![]() |
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 | |
![]() |
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
![]() |
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 la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
[override]
Restituisce una stringa che contiene tutte le proprietà dell'oggetto ErrorEvent. | ErrorEvent | ||
![]() |
Restituisce il valore di base dell'oggetto specificato. | Object |
Costante | Definito da | ||
---|---|---|---|
ERROR : String = "error" [statico]
Definisce il valore della proprietà type di un oggetto evento error. | ErrorEvent |
errorID | proprietà |
errorID:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 10.1 |
Contiene il numero di riferimento associato all'errore specifico. Per un oggetto ErrorEvent personalizzato, questo numero è il valore tratto dal parametro id
fornito nella funzione di costruzione.
Implementazione
public function get errorID():int
ErrorEvent | () | Funzione di costruzione |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Crea un oggetto Event contenente informazioni relative agli eventi di errore. Gli oggetti evento vengono passati ai listener di eventi come parametri.
Parametritype: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 errore: ErrorEvent.ERROR .
| |
bubbles:Boolean (default = false ) — Determina se l'oggetto Event si propaga o meno. 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 .
| |
text:String (default = " ") — Testo da visualizzare come messaggio di errore. I listener di eventi possono accedere a queste informazioni tramite la proprietà text .
| |
id:int (default = 0 ) — Un numero di riferimento da associare all'errore specifico (supportato solo in Adobe AIR).
|
clone | () | metodo |
override public function clone():Event
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Crea una copia dell'oggetto ErrorEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
RestituisceEvent — Un nuovo oggetto ErrorEvent con proprietà dai valori identici a quelli dell'originale.
|
toString | () | metodo |
override public function toString():String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Restituisce una stringa che contiene tutte le proprietà dell'oggetto ErrorEvent. La stringa ha il seguente formato:
[ErrorEvent type=valore bubbles=valore cancelable=valore text=valore errorID=valore]
Nota: il valore errorId
restituito dal metodo toString()
è disponibile solo per Adobe AIR. Anche se Flash Player 10.1 supporta la proprietà errorID
, una chiamata al metodo toString()
sull'oggetto ErrorEvent non fornisce il valore errorId
in Flash Player.
String — Una stringa che contiene tutte le proprietà dell'oggetto ErrorEvent.
|
ERROR | Costante |
public static const ERROR:String = "error"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Definisce il valore della proprietà type
di un oggetto evento error
.
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. |
target | L'oggetto interessato da un errore di funzionamento di rete. |
text | Testo da visualizzare come messaggio di errore. |
errorHandler()
) che cattura più tipi di eventi di errore. Se si verifica un evento ioError
, il gestore tenta di effettuare il caricamento dalla rete, che genera un securityError
.
Nota: questo esempio non funziona se è presente un file di nome MissingFile.xml nella stessa directory del file SWF.
package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.*; public class ErrorEventExample extends Sprite { private var loader:URLLoader; private var request:URLRequest; public function ErrorEventExample() { loader = new URLLoader(); loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, errorHandler); request = new URLRequest(); loadFromFileSystem(); } private function loadFromFileSystem():void { request.url = "MissingFile.xml"; loader.load(request); } private function loadFromNetwork():void { request.url = "http://www.[yourDomain].com/MissingFile.xml"; loader.load(request); } private function errorHandler(event:ErrorEvent):void { trace("errorHandler: " + event); if(event is IOErrorEvent) { loadFromNetwork(); } } } }
Tue Jun 12 2018, 02:44 PM Z