Содержит корневой экранный объект SWF-файла или изображения (JPG, PNG или GIF), загруженного с помощью методов load() или loadBytes().

См. также

Возвращает объект LoaderInfo, соответствующий загружаемому объекту. Объекты LoaderInfo совместно используются объектом Loader и загруженным объектом содержимого. Объект LoaderInfo предоставляет сведения о процессе загрузки и статистику по загружаемому файлу.

События, связанные с загрузкой, отправляются объектом LoaderInfo, на который ссылается свойство contentLoaderInfo объекта Loader. Свойство contentLoaderInfo задается для действительного объекта LoaderInfo, даже если содержимое еще не загружено, чтобы можно было добавить прослушивателей событий объекта перед загрузкой.

См. также

Создает объект Loader, с помощью которого можно загружать файлы, например: SWF, JPEG, GIF или PNG. Вызовите метод load(), чтобы загрузить ресурс в качестве дочернего объекта экземпляра Loader. После этого можно добавить объект Loader в список отображения (например, с помощью метода addChild() экземпляра DisplayObjectContainer). Ресурс отображается в рабочей области по мере загрузки.

Экземпляр Loader можно также использовать автономно, то есть без добавления в контейнер объекта в списке отображения. В этом режиме экземпляр Loader может использоваться для загрузки SWF-файла, содержащего дополнительные модули приложения.

О завершении загрузки SWF-файла можно узнать, используя события объекта LoaderInfo, связанные со свойством contentLoaderInfo объекта Loader. На этом этапе можно выполнить код в модуле SWF-файла, чтобы инициализировать и запустить модуль. В автономном режиме экземпляр Loader можно использовать для загрузки SWF-файла, содержащего компоненты и мультимедийные ресурсы. Опять же, о завершении загрузки компонентов можно узнать с помощью оповещений о событиях объекта LoaderInfo. На этом этапе приложение может начать использовать компоненты и мультимедийные ресурсы в библиотеке SWF-файла, создав экземпляры классов ActionScript 3.0 для их представления.

Чтобы узнать состояние объекта Loader, отслеживайте следующие события, которые объект LoaderInfo связал со свойством contentLoaderInfo объекта Loader.

• Событие open передается после начала загрузки.
• Событие ioError или securityError передается, если загрузка файла невозможна или если в процессе загрузки произошла ошибка.
• Событие progress отправляется постоянно по ходу загрузки файла.
• Событие complete передается после завершения загрузки файла, но до того, как станут доступны методы и свойства загруженного фрагмента ролика.
• Событие init передается после того, как станут доступны свойства и методы загруженного SWF-файла, чтобы можно было приступать к работе с ним. Это событие передается перед обработчиком complete. В потоковых SWF-файлах событие init может происходить намного раньше, чем событие complete. Для большинства целей следует использовать обработчик init.

См. также

Отменяет операцию выполняемого в данный момент метода load() для экземпляра класса Loader.

См. также

Загружает SWF-, JPEG-, прогрессивные JPEG-, неанимированные GIF- или PNG-файлы в объект, являющийся дочерним для объекта Loader. Если загружается анимированный GIF-файл, отображается только первый кадр. Так как объект Loader может содержать только один дочерний объект, отправка последующего запроса load() прекращает обработку предыдущего, если он еще ожидает выполнения, и начинается новая загрузка.

Примечание. Максимальный поддерживаемый размер загружаемого файла приложения составляет 2880 х 2880 пикселов.

SWF-файл или изображение, загруженное в объект Loader наследует свойства положения, поворота и масштаба родительских экранных объектов объекта Loader.

Используйте метод unload() для удаления роликов или изображений, загруженных с помощью этого метода, или для отмены выполняемой операции загрузки.

Можно запретить использование SWF-файлом этого метода путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса Loader.

Дополнительные сведения см. в следующих источниках.

• Раздел центра разработки Flash Player: Безопасность

Параметры

См. также

Выполняет загрузку из двоичных данных, которые хранятся в объекте ByteArray.

При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса Loader.

Параметры

См. также

Удаляет дочерний объект этого объекта Loader, загруженный с помощью метода load(). Параметр property связанного объекта LoaderInfo сброшен до значения null. Дочерний объект не обязательно удаляется, так как на него могут ссылаться другие объекты. Однако он больше не является дочерним для объекта Loader.

Перед загрузкой дочернего SWF-файла лучше всего явно закрыть все потоки объектов дочернего SWF-файла, таких как LocalConnection, NetConnection, NetStream и Sound. В противном случае в дочернем SWF-файле может продолжаться воспроизведение звука, несмотря на его загрузку. Чтобы закрыть потоки в дочернем SWF-файле, добавьте для него прослушиватель события unload. Когда родительский объект вызывает Loader.unload(), дочернему объекту отправляется событие unload. Следующий код показывает, как это делается.

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

См. также

Пытается выгрузить содержимое дочернего SWF-файла и прекращает выполнение команд из загруженных SWF-файлов. Данный метод пытается выгрузить SWF-файлы, загруженные при помощи метода Loader.load() или Loader.loadBytes(), удалив ссылки на объекты EventDispatcher, NetConnection, Timer, Sound или Video дочернего SWF-файла. В результате этого для дочернего SWF-файла и его списка отображения выполняются следующие действия:

• Воспроизведение звука останавливается.
• Удаляются прослушиватели событий рабочей области.
• Удаляются прослушиватели событий enterFrame, frameConstructed, exitFrame, activate и deactivate.
• Таймеры останавливаются.
• Отделяются экземпляры Camera и Microphone.
• Воспроизведение видеороликов прекращается.

Параметры

См. также

1. Создается свойство url, описывающее местоположение и имя файла изображения.
2. В конструкторе LoaderExample создается новый объект Loader с именем loader и затем передается методу configureListeners(), описанному в шаге 3.
3. Конструктор создает новый экземпляр объекта URLRequest, request, и передает url, чтобы сообщить имя и местоположение файла.
4. Объект request передается методу load() объекта loader для загрузки изображения в список отображения.
5. Прослушиватель событий clickHandler зарегистрировал событие click для средства загрузки. После щелчка мыши загруженное изображение выгружается.
6. Метод configureListeners() добавляет семь прослушивателей событий с помощью следующих методов:
   • Метод completeHandler() выполняется по завершении загрузки изображения.
   • Метод httpStatusHandler() выполняется, если изображение не загружено локально и только если доступен сетевой запрос и проигрыватель Flash Player может его обнаружить.
   • Метод initHandler() выполняется перед методом completeHandler() и после метода progressHandler(). Как правило, событие init более полезно при загрузке SWF-файлов.
   • Метод ioErrorHandler() выполняется, если файла изображения нет или он недоступен.
   • Метод openHandler() выполняется при первом открытии изображения.
   • Метод progressHandler() выполняется, когда начинается и когда заканчивается загрузка файла изображения.
   • Метод unLoadHandler() выполняется при выгрузке с использованием метода unload(), когда пользователь нажимает на изображение.

Необходимо учитывать следующие требования.

• В этом примере требуется поместить файл с именем 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();
        }
    }
}