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():int
ErrorEvent | () | 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