Пакетflash.display
Классpublic class LoaderInfo
НаследованиеLoaderInfo Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Класс LoaderInfo обеспечивает сведения о загружаемом SWF-файле или файле изображения (JPEG, GIF или PNG). Объекты LoaderInfo доступны для любых экранных объектов. Предоставляемая информация включает процесс загрузки, URL-адреса загружающего объекта и загружаемого содержимого, общее количество байт и номинальная высота и ширина содержимого.

Обратиться к объектам LoaderInfo можно двумя способами:

Свойство contentLoaderInfo объекта Loader передает информацию о содержимом, загружаемом объектом Loader, а свойство loaderInfo объекта DisplayObject передает информацию о его корневом SWF-файле.

При использовании объекта Loader для загрузки экранного объекта (SWF-файла или растрового изображения), значение свойства loaderInfo экранного объекта совпадает со значением свойства contentLoaderInfo объекта Loader (DisplayObject.loaderInfo = Loader.contentLoaderInfo). Так как экземпляр основного класса SWF-файла не имеет объекта Loader, свойство loaderInfo является единственном способом обращения к LoaderInfo для экземпляра основного класса SWF-файла.

На следующей схеме показаны разные возможности применения объекта LoaderInfo: для экземпляра основного SWF-файла, для свойства contentLoaderInfo объекта Loader и для свойства loaderInfo загруженного объекта.

Изображение с примерами использования LoaderInfo

Некоторые свойства contentLoaderInfo объекта Loader остаются недоступными вплоть до завершения загрузки. Но можно получить такие свойства, как bytesLoaded, bytesTotal, url, loaderURL и applicationDomain. Когда объект loaderInfo отправляет событие init, можно обратиться ко всем свойствам объекта loaderInfo и загруженного изображения или SWF-файла.

Примечание. Все свойства объектов LoaderInfo доступны только для чтения.

Метод EventDispatcher.dispatchEvent() не применим к объектам LoaderInfo. Если вызвать метод dispatchEvent() для объекта LoaderInfo, появится ошибка IllegalOperationError.

Посмотреть примеры

См. также

flash.display.Loader
flash.display.Loader.content
flash.display.DisplayObject
flash.display.DisplayObject.loaderInfo


Общедоступные свойства
 СвойствоОпределено
  actionScriptVersion : uint
[только для чтения] Версия ActionScript загруженного SWF-файла.
LoaderInfo
  applicationDomain : ApplicationDomain
[только для чтения] При загрузке внешнего SWF-файла все определения ActionScript 3.0 в загруженном классе сохраняются в свойстве applicationDomain.
LoaderInfo
  bytes : ByteArray
[только для чтения] Байты, связанные с объектом LoaderInfo.
LoaderInfo
  bytesLoaded : uint
[только для чтения] Число загруженных байт мультимедийного содержимого.
LoaderInfo
  bytesTotal : uint
[только для чтения] Число упакованных байт во всем мультимедийном файле.
LoaderInfo
  childAllowsParent : Boolean
[только для чтения] Означает доверительные отношения со стороны содержимого (дочернего элемента) к загрузчику (родителю).
LoaderInfo
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  content : DisplayObject
[только для чтения] Загруженный объект, связанный с данным объектом LoaderInfo.
LoaderInfo
  contentType : String
[только для чтения] Тип MIME загруженного файла.
LoaderInfo
  frameRate : Number
[только для чтения] Номинальная частота кадров загруженного SWF-файла (в кадрах в секунду).
LoaderInfo
  height : int
[только для чтения] Номинальная высота загруженного файла.
LoaderInfo
  loader : Loader
[только для чтения] Объект Loader, связанный с данным объектом LoaderInfo.
LoaderInfo
  loaderURL : String
[только для чтения] URL-адрес SWF-файла, который запустил загрузку мультимедийного содержимого описанного в данном объекте LoaderInfo.
LoaderInfo
  parameters : Object
[только для чтения] Объект, содержащий пары имен и значений, представляющих параметры для загруженного SWF-файла.
LoaderInfo
  parentAllowsChild : Boolean
[только для чтения] Означает доверительные отношения со стороны загрузчика (родительского элемента) к содержимому (потомку).
LoaderInfo
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  sameDomain : Boolean
[только для чтения] Показывает доменную связь между загрузчиком и содержимым: true (если у них общий исходный домен) или false (в противном случае).
LoaderInfo
  sharedEvents : EventDispatcher
[только для чтения] Экземпляр EventDispatcher, с помощью которого возможен обмен событиями через зоны с разным уровнем безопасности.
LoaderInfo
  swfVersion : uint
[только для чтения] Версия формата загруженного SWF-файла.
LoaderInfo
  url : String
[только для чтения] URL-адрес загружаемого мультимедийного содержимого.
LoaderInfo
  width : int
[только для чтения] Номинальная ширина загруженного содержимого.
LoaderInfo
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
[статические] Возвращает объект LoaderInfo, связанный с SWF-файлом, определенным в качестве объекта.
LoaderInfo
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется после успешной загрузки данных.LoaderInfo
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
  Отправляется, когда совершается сетевой запрос по протоколу HTTP, а проигрыватель Flash Player может определить код состояния HTTP.LoaderInfo
  Отправляется, когда свойства и методы загруженного SWF-файла становятся доступны и готовы к использованию.LoaderInfo
  Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки.LoaderInfo
  Отправляется при запуске операции загрузки.LoaderInfo
  Отправляется в случае получения данных в ходе операции загрузки.LoaderInfo
  Отправляется объектом LoaderInfo каждый раз, когда загруженный объект удаляется с помощью метода unload() объекта Loader, а также когда выполняется повторная загрузка тем же объектом Loader, и перед началом загрузки удаляется исходное содержимое.LoaderInfo
Сведения о свойстве
actionScriptVersionсвойство
actionScriptVersion:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Версия ActionScript загруженного SWF-файла. Версия языка задается с помощью перечислений в классе ActionScriptVersion, таких как ActionScriptVersion.ACTIONSCRIPT2 и ActionScriptVersion.ACTIONSCRIPT3.

Примечание. Это свойство всегда имеет значение ActionScriptVersion.ACTIONSCRIPT2 или ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 и 2.0 указываются как ActionScriptVersion.ACTIONSCRIPT2 (версия 2.0). Это свойство служит только для того, чтобы отличать ActionScript 1.0 и 2.0 от ActionScript 3.0.


Реализация
    public function get actionScriptVersion():uint

Выдает
Error — Если файл загружен недостаточно для получения запрашиваемой информации.
 
Error — Если файл не является SWF-файлом.

См. также

applicationDomainсвойство 
applicationDomain:ApplicationDomain  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

При загрузке внешнего SWF-файла все определения ActionScript 3.0 в загруженном классе сохраняются в свойстве applicationDomain.

Все программные коды в SWF-файле определены для существования в домене приложения. Текущим доменом приложения является домен, где выполняется основное приложение. Системный домен содержит все домены приложений, включая текущий домен, и это означает, что он содержит все классы проигрывателя Flash Player.

Все домены приложений, кроме системного, имеют связанный родительский домен. Родительским доменом свойства applicationDomain основного приложения является системный домен. Загруженные классы определяются только в том случае, если они уже не определены в своих родительских классах. Нельзя перезаписать определение загруженного класса новым определением.

Примеры использования доменов приложений см. в главе "Среда клиентской системы" руководства Программирование на ActionScript 3.0.


Реализация
    public function get applicationDomain():ApplicationDomain

Выдает
SecurityError — Изолированная программная среда безопасности данного вызывающего объекта не имеет доступа к данному домену приложений.

См. также

bytesсвойство 
bytes:ByteArray  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.115.0

Байты, связанные с объектом LoaderInfo.


Реализация
    public function get bytes():ByteArray

Выдает
SecurityError — Если объект, обращающийся к данному API-интерфейсу, не может получить доступ к загруженному объекту из-за ограничений по безопасности. Это может происходить, например, когда объект Loader пытается обратиться к свойству contentLoaderInfo.content и не получает права на доступ к загруженному содержимому по соображениям безопасности.

Дополнительную информацию см. в главе "Безопасность Flash Player" руководства Программирование на ActionScript 3.0.

bytesLoadedсвойство 
bytesLoaded:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Число загруженных байт мультимедийного содержимого. Когда это число равно значению bytesTotal, загружено все содержимое.


Реализация
    public function get bytesLoaded():uint
bytesTotalсвойство 
bytesTotal:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Число упакованных байт во всем мультимедийном файле.

До отправки первого события progress соответствующим объектом Loader данного объекта LoaderInfo, bytesTotal имеет значение 0. После отправки события progress объектом Loader bytesTotal отражает фактическое количество байт для загрузки.


Реализация
    public function get bytesTotal():uint

См. также

childAllowsParentсвойство 
childAllowsParent:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Означает доверительные отношения со стороны содержимого (дочернего элемента) к загрузчику (родителю). Если потомок имеет право доступа к предку, значение — true; в противном случае значение — false. Это свойство имеет значение true, если дочерний объект вызвал метод allowDomain() для предоставления права доступа родительскому домену или если в дочернем домене загружена политика URL-адресов, предоставляющая доступ родительскому домену. Если потомок и предок находятся в том же домене, это свойство имеет значение true.

Дополнительную информацию см. в главе "Безопасность Flash Player" руководства Программирование на ActionScript 3.0.


Реализация
    public function get childAllowsParent():Boolean

Выдает
Error — Выдается исключение, если файл загружен недостаточно для получения запрашиваемой информации.
contentсвойство 
content:DisplayObject  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Загруженный объект, связанный с данным объектом LoaderInfo.


Реализация
    public function get content():DisplayObject

Выдает
SecurityError — Если объект, обращающийся к данному API-интерфейсу, не может получить доступ к загруженному объекту из-за ограничений по безопасности. Это может происходить, например, когда объект Loader пытается обратиться к свойству contentLoaderInfo.content и не получает права на доступ к загруженному содержимому по соображениям безопасности.

Дополнительную информацию см. в главе "Безопасность Flash Player" руководства Программирование на ActionScript 3.0.

contentTypeсвойство 
contentType:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Тип MIME загруженного файла. Имеет значение null, если файл загружен недостаточно для того, чтобы проигрыватель Flash Player мог определить тип. В следующем списке перечислены возможные значения.


Реализация
    public function get contentType():String
frameRateсвойство 
frameRate:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Номинальная частота кадров загруженного SWF-файла (в кадрах в секунду). Значение часто бывает целым числом, хотя это не обязательно.

Это значение может отличаться от фактически используемой частоты кадров. Проигрыватель Flash Player одновременно использует одну частоту кадров для всех загруженных SWF-файлов. Она определяется номинальной частотой кадров основного SWF-файла. Кроме того, Flash Player может не достигать основной частоты кадров, что зависит от аппаратных средств, синхронизации звука и других факторов.


Реализация
    public function get frameRate():Number

Выдает
Error — Если файл загружен недостаточно для получения запрашиваемой информации.
 
Error — Если файл не является SWF-файлом.
heightсвойство 
height:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

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


Реализация
    public function get height():int

Выдает
Error — Если файл загружен недостаточно для получения запрашиваемой информации.
loaderсвойство 
loader:Loader  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Объект Loader, связанный с данным объектом LoaderInfo. Если этот объект LoaderInfo является свойством loaderInfo экземпляра основного класса SWF-файла, с ним не связывается объект Loader.


Реализация
    public function get loader():Loader

Выдает
SecurityError — Если объект, обращающийся к данному API-интерфейсу, не может получить доступ к объекту Loader из-за ограничений по безопасности. Это может происходить, например, когда загруженный SWF-файл пытается обратиться к свойству loaderInfo.loader и не получает права доступа к загружающему SWF-файлу по соображениям безопасности.

Дополнительную информацию см. в главе "Безопасность Flash Player" руководства Программирование на ActionScript 3.0.

loaderURLсвойство 
loaderURL:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

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


Реализация
    public function get loaderURL():String
parametersсвойство 
parameters:Object  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Объект, содержащий пары имен и значений, представляющих параметры для загруженного SWF-файла.

Можно использовать цикл for-in для извлечения всех имен и значений из объекта parameters.

Существует два источника параметров: строка запроса в URL основного SWF-файла и значения HTML-параметра FlashVars (оно затрагивает только основной SWF-файл).

Свойство parameters заменяет технологию ActionScript 1.0 и 2.0, используемую для передачи параметров SWF-файлов в виде свойств основной временной шкалы.

Значение свойства parameters имеет значение null для объектов Loader, содержащих SWF-файлы, использующие ActionScript 1.0 или 2.0. SWF-файлы, использующие ActionScript 3.0, содержатся только в объектах Loader с ненулевым значением.


Реализация
    public function get parameters():Object
parentAllowsChildсвойство 
parentAllowsChild:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Означает доверительные отношения со стороны загрузчика (родительского элемента) к содержимому (потомку). Если предок имеет право доступа к потомку, значение — true; в противном случае значение — false. Это свойство имеет значение true, если родительский объект вызвал метод allowDomain() для предоставления права доступа дочернему домену или если в родительском домене загружена политика URL-адресов, предоставляющая доступ дочернему домену. Если потомок и предок находятся в том же домене, это свойство имеет значение true.

Дополнительную информацию см. в главе "Безопасность Flash Player" руководства Программирование на ActionScript 3.0.


Реализация
    public function get parentAllowsChild():Boolean

Выдает
Error — Выдается исключение, если файл загружен недостаточно для получения запрашиваемой информации.
sameDomainсвойство 
sameDomain:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Показывает доменную связь между загрузчиком и содержимым: true (если у них общий исходный домен) или false (в противном случае).


Реализация
    public function get sameDomain():Boolean

Выдает
Error — Выдается исключение, если файл загружен недостаточно для получения запрашиваемой информации.
sharedEventsсвойство 
sharedEvents:EventDispatcher  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Экземпляр EventDispatcher, с помощью которого возможен обмен событиями через зоны с разным уровнем безопасности. Даже когда загружающий и загружаемый объекты не доверяют друг другу, они оба могут обращаться к sharedEvents.


Реализация
    public function get sharedEvents():EventDispatcher
swfVersionсвойство 
swfVersion:uint  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Версия формата загруженного SWF-файла. Формат файла задается с помощью перечислений в классе SWFVersion, например SWFVersion.FLASH7 и SWFVersion.FLASH9.


Реализация
    public function get swfVersion():uint

Выдает
Error — Если файл загружен недостаточно для получения запрашиваемой информации.
 
Error — Если файл не является SWF-файлом.

См. также

urlсвойство 
url:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

URL-адрес загружаемого мультимедийного содержимого.

Перед отправкой первого события progress соответствующим объектом Loader данного объекта LoaderInfo значение свойства url может отображать только исходный URL-адрес, заданный в вызове метода load() объекта Loader. После первого события progress свойство url отображает окончательный URL-адрес мультимедийного содержимого после того, как выполнено разрешение всех перенаправлений и относительных URL.


Реализация
    public function get url():String

См. также

widthсвойство 
width:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

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


Реализация
    public function get width():int

Выдает
Error — Если файл загружен недостаточно для получения запрашиваемой информации.
Сведения о методе
getLoaderInfoByDefinition()метод
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.115.0

Возвращает объект LoaderInfo, связанный с SWF-файлом, определенным в качестве объекта.

Параметры

object:Object — Объект SWF-файла.

Возвращает
LoaderInfo — Связанный объект LoaderInfo.
Сведения о событии
complete Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.COMPLETE

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется после успешной загрузки данных. Другими словами, это событие отправляется при завершении загрузки всего содержимого. Событие complete всегда отправляется после события init. Событие init отправляется, когда объект становится доступным, хотя загрузка содержимого может продолжаться.

Константа Event.COMPLETE определяет значение свойства type объекта complete.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, который завершил загрузку.

См. также

httpStatus Событие  
Тип объекта события: flash.events.HTTPStatusEvent
свойство HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется, когда совершается сетевой запрос по протоколу HTTP, а проигрыватель Flash Player может определить код состояния HTTP.

Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
statusКод состояния HTTP, возвращенный сервером.
targetСетевой объект, получающий код состояния НТТР.

См. также

init Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.INIT

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется, когда свойства и методы загруженного SWF-файла становятся доступны и готовы к использованию. Содержимое, однако, может продолжать загружаться. Объект LoaderInfo отправляет событие init, когда выполняются два следующих условия:

Например, событие Event.INIT отправляется после загрузки первого кадра ролика или анимации. Тогда ролик становится доступным и может быть добавлен в список отображения. Загрузка ролика полностью, однако, может занять больше времени. Событие Event.COMPLETE отправляется только при полной загрузке ролика.

Событие init всегда предшествует событию complete.

Константа Event.INIT определяет значение свойства typeобъекта события init.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект LoaderInfo, связанный с загружаемым SWF-файлом.

См. также

ioError Событие  
Тип объекта события: flash.events.IOErrorEvent
свойство IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки.

Задает значение свойства type для объекта события ioError.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, с которым произошла ошибка ввода/вывода.
textТекст, отображаемый в качестве сообщения об ошибке.

См. также

open Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.OPEN

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется при запуске операции загрузки.

Константа Event.OPEN определяет значение свойства type объекта события open.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, установивший подключение.

См. также

progress Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется в случае получения данных в ходе операции загрузки.

Задает значение свойства type для объекта события progress.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
bytesLoadedЧисло элементов или байт, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байт, которые в итоге будут получены в случае успешного завершения загрузки.
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, сообщающий сведения о прогрессе.

См. также

unload Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.UNLOAD

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9

Отправляется объектом LoaderInfo каждый раз, когда загруженный объект удаляется с помощью метода unload() объекта Loader, а также когда выполняется повторная загрузка тем же объектом Loader, и перед началом загрузки удаляется исходное содержимое.

Константа Event.UNLOAD определяет значение свойства type объекта события unload.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект LoaderInfo, связанный с выгружаемым или заменяемым SWF-файлом.

См. также

Примеры Как пользоваться примерами
LoaderInfoExample.as

В следующем примере класс LoaderInfoExample используется для вывода изображения в рабочую область. Это можно сделать, выполнив следующие действия.
  1. Создается свойство url, описывающее местоположение и имя изображения.
  2. Конструктор класса создает объект Loader с именем loader.
  3. Объект loader создает экземпляр прослушивателя событий, чтобы обеспечить правильную загрузку изображения.
  4. Конструктор создает новый экземпляр объекта URLRequest, request, и передает url, чтобы сообщить имя и местоположение файла.
  5. Затем объект request передается методу load() объекта loader, который загружает изображение в список отображения.

Важно! В этом примере требуется добавить файл с именем Image.gif в тот же каталог, что и компилированный SWF-файл. Используйте изображение область которого соответствует размерам основного SWF-файла.

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

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

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

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