Loader.progress

可用性

Flash Player 6.0.79。

版本

Flash MX 2004。

用法

用法 1:

on(progress){
  ...
}

用法 2:

listenerObject = new Object();
listenerObject.progress = function(eventObject){
  ...
}
loaderInstance.addEventListener("progress", listenerObject)

描述

事件;在加载内容时向所有已注册的侦听器广播。当 autoload 参数或对 Loader.load() 的调用触发加载操作时,触发该事件。progress 事件并不会始终广播。complete 事件可以在没有调度任何 progress 事件的情况下广播。如果加载的内容是本地文件,尤其会出现这种情况。

第一个用法范例使用一个 on() 处理函数,并且必须直接附加到一个 Loader 组件实例。附加到组件的 on() 处理函数内部使用的关键字 this 是指该组件实例。例如,以下代码附加到 Loader 组件实例 myLoaderComponent,它将“_level0.myLoaderComponent”发送到“输出”面板: 

on(progress){
  trace(this);
}

第二个用法范例使用一个调度程序/侦听器事件模型。组件实例 (loaderInstance) 调度一个事件(在本例中为 progress),而该事件由附加到您创建的侦听器对象 (listenerObject) 的函数处理。您定义一个与侦听器对象上的事件同名的方法;当该事件被触发时,就会调用该方法。该事件被触发时,它会自动将一个事件对象 (eventObject) 传递到侦听器对象方法。每个事件对象都有一组属性,这些属性包含有关该事件的信息。您可以使用这些属性来编写处理该事件的代码。最后,对广播该事件的组件实例调用 UIEventDispatcher.addEventListener() 方法,以将侦听器注册到实例。当该实例调度该事件时,就会调用该侦听器。

有关事件对象的详细信息,请参阅事件对象

范例

以下代码创建一个 Loader 实例,然后为 progress 事件创建一个带有事件处理函数的侦听器对象,该处理函数会将一条关于已加载内容的百分比的消息发送到“输出”面板:

createClassObject(mx.controls.Loader, "loader", 0);
loadListener = new Object();
loadListener.progress = function(eventObj){  
  // eventObj.target 是生成 change 事件的组件,
  // 即 Loader。
  trace("logo.swf is " + loader.percentLoaded + "% loaded."); // 跟踪加载进程
}
loader.addEventListener("progress", loadListener);
loader.contentPath = "logo.swf";