RSLEvent

包	fl.events
类	public class RSLEvent
继承	RSLEvent Event Object

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

RSLEvent 类定义由 RSLPreloader 调度的事件。这些事件指示正在下载 RSL，包括有关加载的文件数和字节数的信息。当使用自定义事件预加载循环，并由 Flash Authoring 自动生成 RSLPreloader 代码时，这些事件由主时间轴调度。在这种情况下，使用 addEventListener，无需参考 RSLPreloader。

相关 API 元素

fl.rsl.RSLPreloader

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		bytesLoaded : int [只读] 返回已成功下载的文件中已下载的总字节数。	RSLEvent
		bytesTotal : int [只读] 返回已下载（无论成功与否）的文件中的总字节数。	RSLEvent
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		rslsFailed : int [只读] 返回下载失败的文件数。	RSLEvent
		rslsLoaded : int [只读] 返回已成功下载的文件数。	RSLEvent
		rslsTotal : int [只读] 返回已下载（无论成功与否）的总文件数。	RSLEvent
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		RSLEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, rslsLoaded:int = 0, rslsFailed:int = 0, rslsTotal:int = 0, bytesLoaded:int = 0, bytesTotal:int = 0) 创建一个其特定信息与 RSL 事件相关的 Event 对象。	RSLEvent
		clone():Event 复制 Event 子类的实例。	Event
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		RSL_LOAD_COMPLETE : String = "rslLoadComplete" [静态] 当成功下载所有 RSL 后由 RSLPreloader 调度的事件。	RSLEvent
		RSL_PROGRESS : String = "rslProgress" [静态] RSLPreloader 调度的事件可指示下载 RSL 文件的进度。	RSLEvent

属性详细信息

bytesLoaded

属性

bytesLoaded:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

返回已成功下载的文件中已下载的总字节数。

实现
public function get bytesLoaded():int

bytesTotal

属性

bytesTotal:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

返回已下载（无论成功与否）的文件中的总字节数。

实现
public function get bytesTotal():int

rslsFailed

属性

rslsFailed:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

返回下载失败的文件数。

实现
public function get rslsFailed():int

rslsLoaded

属性

rslsLoaded:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

返回已成功下载的文件数。

实现
public function get rslsLoaded():int

rslsTotal

属性

rslsTotal:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

返回已下载（无论成功与否）的总文件数。

实现
public function get rslsTotal():int

构造函数详细信息

()

构造函数

public function RSLEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, rslsLoaded:int = 0, rslsFailed:int = 0, rslsTotal:int = 0, bytesLoaded:int = 0, bytesTotal:int = 0)

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

创建一个其特定信息与 RSL 事件相关的 Event 对象。

参数

	`type:String` — 事件的类型。可能的值包括：`RSLEvent.RSL_LOAD_COMPLETE` 和 `RSLEvent.RSL_PROGRESS`。

	`bubbles:Boolean` (default = `false`) — 确定 Event 对象是否参与事件流的冒泡阶段。

	`cancelable:Boolean` (default = `false`) — 确定是否可以取消 Event 对象。

	`rslsLoaded:int` (default = `0`) — 已成功下载的文件数。

	`rslsFailed:int` (default = `0`) — 下载失败的文件数。

	`rslsTotal:int` (default = `0`) — 已下载的总文件数（无论成功与否）。

	`bytesLoaded:int` (default = `0`) — 已成功下载文件的下载字节总数。

	`bytesTotal:int` (default = `0`) — 已下载文件的下载字节总数（无论成功与否）。

常量详细信息

RSL_LOAD_COMPLETE

常量

public static const RSL_LOAD_COMPLETE:String = "rslLoadComplete"

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

当成功下载所有 RSL 后由 RSLPreloader 调度的事件。对于此事件类型，bytesLoaded 和 bytesTotal 属性始终为 0。当使用自定义事件循环进行预加载时，用户内容必须侦听此事件来确定何时退出加载动画循环。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	要添加到显示列表中的 DisplayObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。
`rslsLoaded`	已成功下载的文件数。
`rslsFailed`	下载失败的文件数。
`rslsTotal`	已下载的总文件数（无论成功与否）。
`bytesLoaded`	已成功下载文件的下载字节总数。
`bytesTotal`	已下载文件的下载字节总数（无论成功与否）。

         import fl.events.RSLEvent;
         myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete);
         function loadComplete(e:RSLEvent) {
         gotoAndPlay('startOfContent');
         }

RSL_PROGRESS

常量

public static const RSL_PROGRESS:String = "rslProgress"

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

RSLPreloader 调度的事件可指示下载 RSL 文件的进度。这是唯一一种 bytesLoaded 和 bytesTotal 属性为非零的事件类型。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	要添加到显示列表中的 DisplayObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。
`rslsLoaded`	已成功下载的文件数。
`rslsFailed`	下载失败的文件数。
`rslsTotal`	已下载的总文件数（无论成功与否）。
`bytesLoaded`	已成功下载文件的下载字节总数。
`bytesTotal`	已下载文件的下载字节总数（无论成功与否）。

         import fl.events.RSLEvent;
         myPreloader.addEventListener(RSLEvent.RSL_PROGRESS, progressHandler);
         function progressHandler(e:RSLEvent) {
         trace('rslsLoaded = ' + e.rslsLoaded);
         trace('rslsFailed = ' + e.rslsFailed);
         trace('rslsTotal = ' + e.rslsTotal);
         trace('bytesLoaded = ' + e.bytesLoaded);
         trace('bytesTotal = ' + e.bytesTotal);
         }

RSLEvent - AS3 Flash

类 x

bytesLoaded

bytesTotal

rslsFailed

rslsLoaded

rslsTotal

RSLEvent

RSL_LOAD_COMPLETE

RSL_PROGRESS