语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
ErrorEvent 类仅定义一种类型的 error
事件:ErrorEvent.ERROR
。ErrorEvent 类还充当多个其他错误事件类(包括 AsyncErrorEvent、IOErrorEvent、SecurityErrorEvent、SQLErrorEvent 和 UncaughtErrorEvent 类)的基类。
可以通过为 uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR) 事件注册侦听器来检查不具有任何侦听器的 error
事件。
当内容在 Flash Player 或 AIR Debug Launcher (ADL) 应用程序的调试器版本中运行时,发生未被捕获的错误还会导致显示错误事件的错误对话框出现。
相关 API 元素
属性 | 由以下参数定义 | ||
---|---|---|---|
bubbles : Boolean [只读]
表示事件是否为冒泡事件。 | Event | ||
cancelable : Boolean [只读]
表示是否可以阻止与事件相关联的行为。 | Event | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
currentTarget : Object [只读]
当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | ||
errorID : int [只读]
包含与特定错误相关联的引用数字。 | ErrorEvent | ||
eventPhase : uint [只读]
事件流中的当前阶段。 | Event | ||
target : Object [只读]
事件目标。 | Event | ||
text : String
在 textInput 事件中,由用户输入的字符或字符序列。 | TextEvent | ||
type : String [只读]
事件的类型。 | Event |
方法 | 由以下参数定义 | ||
---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
创建一个 Event 对象,其中包含有关错误事件的信息。 | ErrorEvent | ||
[覆盖]
创建 ErrorEvent 对象的副本,并设置每个属性的值以匹配原始属性值。 | ErrorEvent | ||
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | ||
表示对象是否已经定义了指定的属性。 | Object | ||
检查是否已对事件调用 preventDefault() 方法。 | Event | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
如果可以取消事件的默认行为,则取消该行为。 | Event | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | ||
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回一个字符串,其中包含 ErrorEvent 对象的所有属性。 | ErrorEvent | ||
返回指定对象的原始值。 | Object |
errorID | 属性 |
ErrorEvent | () | 构造函数 |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
创建一个 Event 对象,其中包含有关错误事件的信息。将 Event 对象作为参数传递给事件侦听器。
参数type:String — 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERROR 。
| |
bubbles:Boolean (default = false ) — 确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。
| |
cancelable:Boolean (default = false ) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。
| |
text:String (default = " ") — 要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。
| |
id:int (default = 0 ) — 与特定错误关联的引用编号(仅在 Adobe AIR 中支持)。
|
clone | () | 方法 |
toString | () | 方法 |
override public function toString():String
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
返回一个字符串,其中包含 ErrorEvent 对象的所有属性。字符串的格式如下:
[ErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]
注意: toString()
方法返回的 errorId
值只可用于 Adobe AIR。虽然 Flash Player 10.1 支持 errorID
属性,但在 Flash Player 中对 ErrorEvent 对象调用 toString()
并不提供 errorId
值。
String — 一个字符串,其中包含 ErrorEvent 对象的所有属性。
|
ERROR | 常量 |
public static const ERROR:String = "error"
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
定义 error
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 发生网络操作失败的对象。 |
text | 要显示为错误消息的文本。 |
errorHandler()
) 的使用。如果有 ioError
事件,处理函数将试图从网络加载,然后引发 securityError
。
注意:如果将名为 MissingFile.xml 的文件与您的 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, 11:04 AM Z