Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
fl.display 

ProLoaderInfo  - AS3 Flash

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

Этот класс используется ProLoader вместо LoaderInfo. Он является зеркалом API-интерфейсов LoaderInfo для безопасной загрузки SWF-файлов, которые используют TLF со стандартными параметрами предзагрузки RSL. Этот класс предусматривает поддержку более ранних вплоть до Flash Player 9.

Некоторые элементы этого класса, включая childSandboxBridge и parentSandboxBridge, поддерживаются не во всех версиях Flash Player и AIR. Вызывайте эти свойства, только когда опубликованное содержимое AIR или версия Flash Player их поддерживает. Вызов этих свойств в других контекстах приводит к появлению ошибок во время выполнения.

Связанные элементы API



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

actionScriptVersion

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

Версия 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

Связанные элементы API

applicationDomain

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

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

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

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



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

Связанные элементы API

bytes

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

bytesLoaded

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

bytesTotal

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

childAllowsParent

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность.



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

Связанные элементы API

    

childSandboxBridge

свойство 
childSandboxBridge:Object

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: AIR 1.0

Объект, который может быть задан кодом загруженного содержимого, чтобы сделать свойства и методы доступными для кода в изолированной программной среде объекта ProLoader. Мост изолированной программной среды позволяет содержимому не из домена приложения получить управляемый доступ к сценариям в изолированной программной среде приложения AIR, и наоборот. Этот мост служит своеобразным шлюзом между изолированными программными средами, обеспечивая открытое взаимодействие между изолированной программной средой приложения и другими изолированными средами.



Реализация
    public function get childSandboxBridge():Object
    public function set childSandboxBridge(value:Object):void

Выдает
SecurityError — Только содержимое в изолированной программной среде загруженного содержимого может задать это свойство.

Связанные элементы API

content

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

contentType

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

  • "application/x-shockwave-flash"
  • "image/jpeg"
  • "image/gif"
  • "image/png"



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

Связанные элементы API

frameRate

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

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



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

Связанные элементы API

height

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

isURLInaccessible

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 10.1, AIR 2

Указывает, усечено ли свойство ProLoaderInfo.url. Когда свойство isURLInaccessible имеет значение true, свойство ProLoaderInfo.url содержит только домен конечного URL-адреса, с которого загружается содержимое. Например, свойство усекается, если содержимое загружается со страницы http://www.adobe.com/assets/hello.swf, а свойство ProLoaderInfo.url имеет значение http://www.adobe.com. Свойство isURLInaccessible имеет значение true, только когда верны все перечисленные ниже условия.

  • Во время загрузки содержимого произошла переадресация HTTP.
  • SWF-файл, вызывающий метод ProLoaderInfo.load(), находится не в том домене, к которому относится конечный URL-адрес содержимого.
  • SWF-файл, вызывающий метод ProLoaderInfo.load(), не имеет разрешения на доступ к содержимому. Разрешение на доступ к содержимому предоставляется так же, как для метода BitmapData.draw(): вызовите метод Security.allowDomain(), чтобы получить доступ к SWF-файлу (или, если требуется доступ к другому типу содержимого, создайте файл политики и используйте свойство LoaderContext.checkPolicyFile).

Примечание. Свойство isURLInaccessible впервые добавлено в версии Flash Player 10.1 и AIR 2.0. Однако оно доступно для SWF-файлов, созданных во всех версиях, если его поддерживает среда выполнения Flash. Таким образом, использование «строгого режима» в некоторых инструментах разработки приводит к возникновению ошибки. Чтобы обойти эту ошибку, используйте косвенный синтаксис myLoaderInfo ["isURLInaccessible"] или выключите строгий режим. Если для разработки используется ПО Flash Professional CS5 или Flex SDK 4.1, этот API-интерфейс можно использовать и скомпилировать для сред выполнения, выпущенных до Flash Player 10.1 и AIR 2.

Для содержимого приложения в AIR это свойство всегда имеет значение false.



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

Связанные элементы API

loader

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

loaderURL

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

parameters

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

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

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

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

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



Реализация
    public function get parameters():Object

Связанные элементы API

parentAllowsChild

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность.



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

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

Связанные элементы API

    

parentSandboxBridge

свойство 
parentSandboxBridge:Object

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: AIR 1.0

Объект, который может быть задан с помощью кода в изолированной программной среде объекта ProLoader, чтобы сделать свойства и методы доступными для кода загруженного содержимого. Мост изолированной программной среды позволяет содержимому не из домена приложения получить управляемый доступ к сценариям в изолированной программной среде приложения AIR, и наоборот. Этот мост служит своеобразным шлюзом между изолированными программными средами, обеспечивая открытое взаимодействие между изолированной программной средой приложения и другими изолированными средами.



Реализация
    public function get parentSandboxBridge():Object
    public function set parentSandboxBridge(value:Object):void

Выдает
SecurityError — Только содержимое в изолированной программной среде объекта ProLoader может задать это свойство.

Связанные элементы API

sameDomain

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

sharedEvents

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

Из-за проблем синхронизации при загрузке содержимого, выполняющего предварительную загрузку RSL, рекомендуется дождаться получения события init, прежде чем добавлять прослушиватели событий для объекта sharedEvents, или добавить их повторно при получении события init.



Реализация
    public function get sharedEvents():EventDispatcher

Связанные элементы API

swfVersion

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API

url

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

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

В некоторых случаях значение свойства url усекается; дополнительные сведения см. в описании свойства isURLInaccessible.



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

width

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

Язык версии: ActionScript 3.0
Версия продукта: Flash CS5.5
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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



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

Связанные элементы API





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.