Paquete | flash.events |
Clase | public class ErrorEvent |
Herencia | ErrorEvent TextEvent Event Object |
Subclases | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.0, Flash Lite 4 |
La clase ErrorEvent sólo define un tipo de evento error
: ErrorEvent.ERROR
. La clase ErrorEvent también actúa como clase base para otras clases de eventos de error, incluidas las clases AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent y UncaughtErrorEvent.
Es posible comprobar eventos error
que no tengan ningún detector registrando un detector de eventos para el evento uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR).
Un error sin capturar también hace que aparezca un cuadro de diálogo de error con el evento de error cuando el contenido se ejecuta en la versión de depurador de Flash Player o en la aplicación AIR Debug Launcher (ADL).
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | ||
cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | ||
errorID : int [solo lectura]
Contiene el número de referencia asociado al error concreto. | ErrorEvent | ||
eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | ||
target : Object [solo lectura]
El destino del evento. | Event | ||
text : String
Para un evento textInput, el carácter o la secuencia de caracteres introducidos por el usuario. | TextEvent | ||
type : String [solo lectura]
El tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Crea un objeto de evento que contiene información sobre eventos de error. | ErrorEvent | ||
[override]
Crea una copia del objeto ErrorEvent y define el valor de cada propiedad para que coincida con el del objeto original. | ErrorEvent | ||
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Comprueba si se ha llamado a preventDefault() en el evento. | Event | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | ||
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
[override]
Devuelve una cadena con todas las propiedades del objeto ErrorEvent. | ErrorEvent | ||
Devuelve el valor simple del objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
ERROR : String = "error" [estática]
Define el valor de la propiedad type para un objeto de evento error. | ErrorEvent |
errorID | propiedad |
errorID:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.1 |
Contiene el número de referencia asociado al error concreto. En el caso de un objeto ErrorEvent personalizado, este número es el valor del parámetro id
proporcionado en el constructor.
Implementación
public function get errorID():int
ErrorEvent | () | Información sobre |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Crea un objeto de evento que contiene información sobre eventos de error. Los objetos de evento se transfieren como parámetros a los detectores de eventos.
Parámetrostype:String — El tipo de evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad type heredada. Sólo hay un tipo de evento de error: ErrorEvent.ERROR .
| |
bubbles:Boolean (default = false ) — Determina si el objeto de evento se propaga. Los detectores de eventos pueden acceder a esta información a través de la propiedad bubbles heredada.
| |
cancelable:Boolean (default = false ) — Determina si se puede cancelar el objeto Event. Los detectores de eventos pueden acceder a esta información a través de la propiedad cancelable heredada.
| |
text:String (default = " ") — Texto que se mostrará como mensaje de error. Los detectores de eventos pueden acceder a esta información a través de la propiedad text .
| |
id:int (default = 0 ) — Un número de referencia para asociarlo al error concreto (se admite sólo en Adobe AIR).
|
clone | () | método |
override public function clone():Event
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Crea una copia del objeto ErrorEvent y define el valor de cada propiedad para que coincida con el del objeto original.
Valor devueltoEvent — Un nuevo objeto ErrorEvent con valores de propiedades que coinciden con los del objeto original.
|
toString | () | método |
override public function toString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Devuelve una cadena con todas las propiedades del objeto ErrorEvent. La cadena tiene el siguiente formato:
[ErrorEvent type=valor bubbles=valor cancelable=valor text=valor errorID=valor]
Nota: El valor de errorId
devuelto por el método toString()
sólo está disponible en Adobe AIR. Mientras Flash Player 10.1 admite la propiedad errorID
, llamar a toString()
en el objeto ErrorEvent no proporciona el valor de errorID
en Flash Player.
String — Una cadena que contiene todas las propiedades del objeto ErrorEvent.
|
ERROR | Constante |
public static const ERROR:String = "error"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define el valor de la propiedad type
de un objeto de evento error
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto en el que se produce un error de operación de red. |
text | Texto que se mostrará como mensaje de error. |
errorHandler()
) que captura varios tipos de eventos de error. Si se produce un evento ioError
, el controlador intenta cargarlo desde la red. Esto genera un error securityError
.
Nota: este ejemplo no funciona si tiene un archivo llamado MissingFile.xml en el mismo directorio que el archivo 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:12 PM Z