| Pacote | flash.events |
| Classe | public class ErrorEvent |
| Herança | ErrorEvent TextEvent Event Object |
| Subclasses | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A classe ErrorEvent define só um tipo de evento error: ErrorEvent. ERRO. A classe ErrorEvent também serve como classe base de várias outras classes de evento de erro, inclusive classes AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent e UncaughtErrorEvent.
Você pode procurar os eventos error que não têm nenhum ouvinte registrando um ouvinte para o evento uncaughtError (UncaughtErrorEvent. UNCAUGHT_ERROR).
Um erro não detectado também abre uma caixa de diálogo de erro que exibe o evento para aparecer quando o conteúdo estiver sendo executado na versão do depurador do Flash Player ou no aplicativo Lançador de Depuração de AIR (ADL).
Elementos da API relacionados
| Propriedade | Definido por | ||
|---|---|---|---|
![]() | bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
![]() | cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
![]() | currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
| errorID : int [somente leitura]
Contém o número de referência associado ao erro específico. | ErrorEvent | ||
![]() | eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
![]() | target : Object [somente leitura]
O destino de evento. | Event | |
![]() | text : String
Para um evento textInput, o caractere ou string inserida pelo usuário. | TextEvent | |
![]() | type : String [somente leitura]
O tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Cria um objeto Event que contém informações sobre eventos de erro. | ErrorEvent | ||
[substituir]
Cria uma cópia do objeto ErrorEvent e define o valor de cada propriedade para corresponder ao do original. | ErrorEvent | ||
![]() |
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
![]() |
Indica se um objeto tem uma propriedade especificada definida. | Object | |
![]() |
Verifica se o método preventDefault() foi chamado no evento. | Event | |
![]() |
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
![]() |
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
![]() |
Indica se a propriedade especificada existe e é enumerável. | Object | |
![]() |
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
![]() |
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
![]() |
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
![]() |
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto ErrorEvent. | ErrorEvent | ||
![]() |
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| ERROR : String = "error" [estático]
Define o valor da propriedade de tipo de um objeto de evento de erro. | ErrorEvent | ||
errorID | propriedade |
errorID:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Contém o número de referência associado ao erro específico. Para um objeto ErrorEvent personalizado, esse número é o valor do parâmetro id fornecido no construtor.
Implementação
public function get errorID():intErrorEvent | () | Construtor |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Cria um objeto Event que contém informações sobre eventos de erro. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.
Parâmetrostype:String — O tipo de evento. Ouvintes de eventos podem acessar essas informações por meio da propriedade type herdada. Só existe um tipo de evento de erro: ErrorEvent.ERROR.
| |
bubbles:Boolean (default = false) — Determina se o objeto Event cria bolhas. Ouvintes de eventos podem acessar essas informações por meio da propriedade bubbles herdada.
| |
cancelable:Boolean (default = false) — Determina se o objeto Event pode ser cancelado. Ouvintes de eventos podem acessar essas informações por meio da propriedade cancelable herdada.
| |
text:String (default = "") — Texto a ser exibido como uma mensagem de erro. Ouvintes de eventos podem acessar essas informações por meio da propriedade text.
| |
id:int (default = 0) — Um número de referência a ser associado ao erro específico (suporte apenas no Adobe AIR).
|
clone | () | método |
override public function clone():Event| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Cria uma cópia do objeto ErrorEvent e define o valor de cada propriedade para corresponder ao do original.
RetornaEvent — Um novo objeto ErrorEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma string que contém todas as propriedades do objeto ErrorEvent. A string está no seguinte formato:
[ErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]
Nota: o valor errorId retornado pelo métodos toString() só está disponível para o Adobe AIR. Enquanto que o Flash Player 10.1 suporta a propriedade errorID, chamar toString() no objeto ErrorEvent não fornece o valor errorId no Flash Player.
String — Uma string que contém todas as propriedades do objeto ErrorEvent.
|
ERROR | Constante |
public static const ERROR:String = "error"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o valor da propriedade type de um objeto de evento error.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que está passando por uma falha de operação na rede. |
text | Texto a ser exibido como uma mensagem de erro. |
errorHandler()) que captura vários tipos de eventos de erro. Na ocorrência de um evento ioError, o manipulador tenta carregar a partir da rede, que então lança um securityError.
Observação: Este exemplo não funcionará se você tiver um arquivo com o nome MissingFile.xml no mesmo diretório do arquivo 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();
}
}
}
}
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas