包含使用 load() 或 loadBytes() 方法加载的 SWF 文件或图像（JPG、PNG 或 GIF）文件的根显示对象。

另请参见

返回与正在加载的对象相对应的 LoaderInfo 对象。 LoaderInfo 对象在 Loader 对象和加载的内容对象之间共享。 LoaderInfo 对象提供有关加载的文件的加载进度信息和统计。

与加载相关的事件由 Loader 对象的 contentLoaderInfo 属性引用的 LoaderInfo 对象调度。 contentLoaderInfo 属性设置为有效的 LoaderInfo 对象（即使在加载内容之前），这样您就可以在加载前将事件侦听器添加到该对象。

另请参见

创建一个可用于加载文件（如 SWF、JPEG、GIF 或 PNG 文件）的 Loader 对象。 调用 load() 方法可将资源加载为 Loader 实例的子级。 然后，可以将 Loader 对象添加到显示列表（例如，通过使用 DisplayObjectContainer 实例的 addChild() 方法）。 这样，资源在加载时会出现在舞台上。

您也可以在“offlist”模式下使用 Loader 实例，这样就不会将 Loader 实例添加到显示列表的显示对象容器中。 在该模式下，Loader 实例可以用于加载包含应用程序的其它模块的 SWF 文件。

要检测何时可以完成 SWF 文件的加载，您可以使用与 Loader 对象的 contentLoaderInfo 属性相关联的 LoaderInfo 对象的事件。 此时，便可执行模块 SWF 文件中的代码以初始化和启动模块。 在 offlist 模式下，还可以使用 Loader 实例来加载包含组件或媒体资源的 SWF 文件。 同时，您可以使用 LoaderInfo 对象事件通知来检测何时完成组件的下载。 此时，应用程序可以通过实例化代表这些组件和资源的 ActionScript 3.0 类来开始使用 SWF 文件库中的组件和媒体资源。

要确定 Loader 对象的状态，请监视与 Loader 对象的 contentLoaderInfo 属性相关联的 LoaderInfo 对象的以下事件：

• 在加载开始时调度 open 事件。
• 在无法加载文件或在加载过程中出现错误时，调度 ioError 或 securityError 事件。
• 在文件加载过程中会不断引发 progress 事件。
• 在文件完成下载但加载的影片剪辑的方法和属性尚不可用时调度 complete 事件。
• 在可以访问加载的 SWF 文件的属性和方法，即可以开始操作加载的 SWF 文件时调度 init 事件。 在 complete 处理函数之前调度该事件。 在流式 SWF 文件中，init 事件可以在明显早于 complete 事件的时间发生。 在大多数情况下，请使用 init 处理函数。

另请参见

取消当前正在对 Loader 实例执行的 load() 方法操作。

另请参见

将 SWF、JPEG、渐进式 JPEG、非动画 GIF 或 PNG 文件加载到此 Loader 对象的子对象中。 如果加载 GIF 动画文件，将仅显示第一帧。 由于 Loader 对象可以只包含一个子级，因此，发出后续 load() 请求将终止先前的请求，如果仍然存在未处理的请求，则会开始新的加载。

加载到 Loader 对象中的 SWF 文件或图像会继承该 Loader 对象的父显示对象的位置、旋转和缩放属性。

使用 unload() 方法可删除用此方法加载的影片或图像，或者取消正在进行中的加载操作。

使用 load() 方法时，请考虑 Flash Player 安全模型：

• 您可以加载来自任何可访问源的内容。
• 如果执行调用的 SWF 文件位于网络沙箱中并且要加载的文件是本地的，则不允许加载。
• 如果加载的内容为 SWF 文件，那么除非可以通过调用加载的内容文件中的 Security.allowDomain() 方法来允许跨脚本排列，否则另一个安全沙箱中的 SWF 文件不能对它执行脚本操作。
• 加载为 AVM1Movie 对象的 SWF 文件（用 ActionScript 1.0 或 2.0 编写的）不能对加载为 Sprite 或 MovieClip 对象的 SWF 文件（用 ActionScript 3.0 编写的）执行跨脚本操作。 但是，可以使用 LocalConnection 类使这些文件能够互相通信。
• 如果加载的内容为图像，那么除非该 SWF 文件的域包含在该图像原始域的跨域策略文件中，否则安全沙箱之外的 SWF 文件无法访问其数据。
• 在只能与本地文件系统的内容交互的沙箱中的影片剪辑不能对只能与远程内容交互的沙箱中的影片剪辑使用脚本，反之亦然。
• 可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数，防止 SWF 文件使用此方法。

有关详细信息，请参阅以下部分：

• security chapter（在《ActionScript 3.0 编程》一书中）和有关 LiveDocs 的最新注释
• Flash Player 9 Security White Paper

参数

另请参见

从 ByteArray 对象中所存储的二进制数据中加载。

参数

另请参见

删除此 Loader 对象中使用 load() 方法加载的子项。 将关联 LoaderInfo 对象的 property 重置为 null。 不必破坏子级，因为其它对象可能要引用它；但是，它不再是 Loader 对象的子级。

最佳做法是，在卸载子 SWF 文件之前，您应该显式关闭子 SWF 文件的对象（如 LocalConnection、NetConnection、NetStream 和 Sound 对象）中的任何流。 否则，子 SWF 文件中的音频可能会继续播放，即使已卸载子级 SWF 文件。 要关闭子 SWF 文件中的流，请向子文件中添加事件侦听器以侦听 unload 事件。 当父文件调用 Loader.unload() 时，将为子文件调度 unload 事件。 以下代码显示了完成上述任务的方法：

function closeAllStreams(evt:Event) { myNetStream.close(); mySound.close(); myNetConnection.close(); myLocalConnection.close(); } myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

另请参见

1. 创建 url 属性，它是图像文件的位置和名称
2. 在 LoaderExample 构造函数中，创建一个新的 Loader 对象，名为 loader，该对象随后被传递给 configureListeners() 方法，如步骤 3 所述。
3. 构造函数创建一个 URLRequest 对象的新实例 request，该实例带有传递的 url，这样，就可以知道文件的名称和位置。
4. request 对象传递给 loader 对象的 load() 方法，该方法会将图像加载到显示列表上。
5. 为加载器上的 click 事件注册 clickHandler 事件侦听器。 在单击鼠标后，便可卸载加载的图像。
6. configureListeners() 方法通过以下方法添加 7 个事件侦听器：
   • 图像加载完成时，执行 completeHandler() 方法。
   • 图像不是在本地加载，并且只有在网络请求可用并可被 Flash Player 检测到的情况下，才会执行 httpStatusHandler() 方法。
   • initHandler() 方法在 completeHandler() 方法之前、progressHandler() 方法之后执行。 通常，init 事件在加载 SWF 文件时更有用。
   • 图像文件不可用或不可访问，则执行 ioErrorHandler() 方法。
   • 首次打开图像文件时，执行 openHandler() 方法。
   • 图像文件开始下载和下载完成时，执行 progressHandler() 方法。
   • 通过使用用户单击图像时使用的 unload() 方法卸载图像时，执行 unLoadHandler() 方法。

请牢记以下要求：

• 该示例要求您将名为 Image.gif 的文件放置在与经过编译的 SWF 文件相同的目录中。 使用具有一个适合主 SWF 文件尺寸的区域的图像。
• 虽然该示例使用可用于 LoaderInfo 对象的所有事件，但是在大部分情况下，只需要一个子集。 特别是在只加载图像文件时，complete 事件（还可能是 ioError 事件）足够用于加载本地图像。

package {
    import flash.display.Loader;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderExample() {
            var loader:Loader = new Loader();
            configureListeners(loader.contentLoaderInfo);
            loader.addEventListener(MouseEvent.CLICK, clickHandler);

            var request:URLRequest = new URLRequest(url);
            loader.load(request);

            addChild(loader);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(Event.INIT, initHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(Event.UNLOAD, unLoadHandler);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function initHandler(event:Event):void {
            trace("initHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler: bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function unLoadHandler(event:Event):void {
            trace("unLoadHandler: " + event);
        }

        private function clickHandler(event:MouseEvent):void {
            trace("clickHandler: " + event);
            var loader:Loader = Loader(event.target);
            loader.unload();
        }
    }
}