| 包 | fl.events |
| 类 | public class RSLErrorEvent |
| 继承 | RSLErrorEvent  ErrorEvent TextEvent Event Object |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flash CS5 |
| 运行时版本: | Flash Player 10.1, AIR 2 |
RSLPreloader 调度的错误事件。此事件指示下载 RSL 已失败，并提供有关已失败的文件的信息和尝试下载及下载已失败的文件的数量。当使用自定义事件预加载循环，并由 Flash Authoring 自动生成 RSLPreloader 代码时，该事件由主时间轴调度。在这种情况下，使用 addEventListener，无需参考 RSLPreloader。
相关 API 元素
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | bubbles : Boolean [只读]
表示事件是否为冒泡事件。 | Event | |
| cancelable : Boolean [只读]
表示是否可以阻止与事件相关联的行为。 | Event | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| currentTarget : Object [只读]
当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | |
| errorID : int [只读]
包含与特定错误相关联的引用数字。 | ErrorEvent | |
| eventPhase : uint [只读]
事件流中的当前阶段。 | Event | |
| failedURLs : Array [只读]
返回下载失败的文件数组。 | RSLErrorEvent | ||
| rslsFailed : int [只读]
返回下载失败的文件数。 | RSLErrorEvent | ||
| rslsLoaded : int [只读]
返回已成功下载的文件数。 | RSLErrorEvent | ||
| rslsTotal : int [只读]
返回已下载（无论成功与否）的总文件数。 | RSLErrorEvent | ||
| target : Object [只读]
事件目标。 | Event | |
| text : String
在 textInput 事件中，由用户输入的字符或字符序列。 | TextEvent | |
| type : String [只读]
事件的类型。 | Event | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
RSLErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, rslsLoaded:int = 0, rslsFailed:int = 0, rslsTotal:int = 0, failedURLs:Array = null)
创建包含有关 RSLError 事件信息的 RSLErrorEvent 对象。 | RSLErrorEvent | ||
| [覆盖]
创建 ErrorEvent 对象的副本，并设置每个属性的值以匹配原始属性值。 | ErrorEvent | |
|
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
检查是否已对事件调用 preventDefault() 方法。 | Event | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
如果可以取消事件的默认行为，则取消该行为。 | Event | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
设置循环操作动态属性的可用性。 | Object | |
|
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | |
|
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
| [覆盖]
返回一个字符串，其中包含 ErrorEvent 对象的所有属性。 | ErrorEvent | |
|
返回指定对象的原始值。 | Object | |
公共常量
| 常量 | 由以下参数定义 | ||
|---|---|---|---|
| RSL_LOAD_FAILED : String = "rslLoadFailed" [静态]
当所有 RSL 已完成下载并且其中一个或多个 RSL 下载失败时由 RSLPreloader 调度的错误。 | RSLErrorEvent | ||
属性详细信息
failedURLs | 属性 |
rslsFailed | 属性 |
rslsLoaded | 属性 |
rslsTotal | 属性 |
构造函数详细信息
RSLErrorEvent | () | 构造函数 |
public function RSLErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, rslsLoaded:int = 0, rslsFailed:int = 0, rslsTotal:int = 0, failedURLs:Array = null)| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flash CS5 |
| 运行时版本: | Flash Player 10.1, AIR 2 |
创建包含有关 RSLError 事件信息的 RSLErrorEvent 对象。RSLErrorEvent 对象已作为参数传递给事件侦听器。
参数type:String — 事件的类型。可能的值包括：RSLEvent.RSL_LOAD_COMPLETE 和 RSLEvent.RSL_PROGRESS。
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false) | |
rslsLoaded:int (default = 0) | |
rslsFailed:int (default = 0) | |
rslsTotal:int (default = 0) | |
failedURLs:Array (default = null) |
常量详细信息
RSL_LOAD_FAILED | 常量 |
public static const RSL_LOAD_FAILED:String = "rslLoadFailed"| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flash CS5 |
| 运行时版本: | Flash Player 10.1, AIR 2 |
当所有 RSL 已完成下载并且其中一个或多个 RSL 下载失败时由 RSLPreloader 调度的错误。当使用自定义事件循环进行预加载时，用户内容必须侦听此事件来确定何时退出加载动画循环。
此事件具有以下属性：
| 属性 | 值 |
|---|---|
bubbles | true |
cancelable | false；没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 要添加到显示列表中的 DisplayObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
rslsLoaded | 已成功下载的文件数。 |
rslsFailed | 下载失败的文件数。 |
rslsTotal | 已下载的总文件数（无论成功与否）。 |
failedURLs | 下载失败的一组文件。 |
import fl.events.RSLErrorEvent;
myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler);
function rslLoadFailedHandler(e:RSLErrorEvent) {
gotoAndPlay('rslLoadFailure');
}
相关 API 元素
Tue Jun 12 2018, 11:04 AM Z