| Пакет | fl.display |
| Класс | public class ProLoader |
| Наследование | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Примечание. ProLoader не является подклассом класса flash.display.Loader. Чтобы использовать ProLoader, необходимо заменить все ссылки на тип Loader ссылками на тип ProLoader.
ProLoader обеспечивает последовательную загрузку. Это особенно полезно в отношении SWF-файлов, для которых используется предварительная загрузка RSL. Например, SWF-файлы, которые используют текст TLF, по умолчанию используют предварительную загрузку RSL. В этих случаях ProLoaderInfo задерживает отправку событий INIT или COMPLETE до тех пор, пока не завершился предварительная загрузка RSL, и реальное содержимое не станет доступным. Соответственно, свойство content будет после этого иметь доступ к реальному содержимому. Класс ProLoader также помогает избежать других проблем, таких как:
- Дополнительные события
addedToStageиremovedFromStage. - Содержимое, которое загружено в неверный родительский объект в первом кадре (относится к содержимому, опубликованному во Flash Player 10.2 или более поздней версии с использованием Flash Professional CS5.5 или более поздней версии).
Внимание! Некоторые элементы ProLoader поддерживают не все версии среды выполнения. Обращайтесь к этим элементам, только когда опубликованное содержимое AIR или версия Flash Player их поддерживает. В противном случае эти API-интерфейсы будут выдавать ошибки времени выполнения. Элементы с ограниченной поддержкой среды выполнения включают следующие методы и свойства:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Информацию о поддержки API-интерфейсом среды выполнения можно найти в соответствующих справочных разделах.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| content : DisplayObject [только для чтения]
Содержит корневой экранный объект SWF-файла или изображения (JPG, PNG или GIF), загруженного с помощью методов load() или loadBytes(). | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [только для чтения]
Возвращает объект ProLoaderInfo, соответствующий загружаемому объекту. | ProLoader | ||
| contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
| doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен. | Sprite | |
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
| graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
| height : Number
Указывает высоту экранного объекта в пикселях. | DisplayObject | |
| hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | |
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | |
| numChildren : int [только для чтения]
Возвращает число дочерних элементов данного объекта. | DisplayObjectContainer | |
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
| rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | DisplayObject | |
| rotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
| rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | DisplayObject | |
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | DisplayObjectContainer | |
| tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | |
| tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [только для чтения]
Объект, который отправляет событие uncaughtError при возникновении необработанной ошибки в коде SWF-файла данного объекта ProLoader. | ProLoader | ||
| useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
| visible : Boolean
Определяет видимость экранного объекта. | DisplayObject | |
| width : Number
Указывает ширину экранного объекта в пикселях. | DisplayObject | |
| x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject | |
| Метод | Определено | ||
|---|---|---|---|
Создает объект ProLoader, с помощью которого можно загружать файлы таких форматов, как SWF, JPEG, GIF или PNG. | ProLoader | ||
|
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
|
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | DisplayObjectContainer | |
Отменяет операцию метода load(), выполняемую в настоящий момент для экземпляра ProLoader. | ProLoader | ||
|
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | |
|
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
|
Возвращает позицию индекса для экземпляра DisplayObject child. | DisplayObjectContainer | |
|
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Загружает SWF-, JPEG-, прогрессивные JPEG-, неанимированные GIF- или PNG-файлы в объект, являющийся дочерним для объекта ProLoader. | ProLoader | ||
Выполняет загрузку из двоичных данных, которые хранятся в объекте ByteArray. | ProLoader | ||
Загружает экземпляр IFilePromise через параметр promise. | ProLoader | ||
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Вызывает виртуальную клавиатуру. | InteractiveObject | |
|
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | DisplayObjectContainer | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
|
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | |
|
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | |
|
Завершает метод startDrag(). | Sprite | |
|
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | |
|
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | DisplayObjectContainer | |
|
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | DisplayObjectContainer | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
Удаляет дочерний объект этого объекта ProLoader, загруженный с помощью метода load(). | ProLoader | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
content | свойство |
content:DisplayObject [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Содержит корневой экранный объект SWF-файла или изображения (JPG, PNG или GIF), загруженного с помощью методов load() или loadBytes().
Реализация
public function get content():DisplayObjectВыдает
SecurityError — Загруженный SWF-файл или файл изображения принадлежит изолированной программной среде безопасности, к которой у вас нет доступа. Чтобы избежать такой ситуации, при вызове метода load() или loadBytes() загружаемый SWF-файл должен вызвать метод Security.allowDomain() либо загружающий файл должен указать параметр loaderContext со свойством securityDomain в значении SecurityDomain.currentDomain.
|
contentLoaderInfo | свойство |
contentLoaderInfo:ProLoaderInfo [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Возвращает объект ProLoaderInfo, соответствующий загружаемому объекту. Объекты ProLoaderInfo совместно используются объектом ProLoader и загруженным объектом содержимого. Объект ProLoaderInfo предоставляет сведения о процессе загрузки и статистику по загружаемому файлу.
События, связанные с загрузкой, отправляются объектом ProLoaderInfo, на который ссылается свойство contentLoaderInfo объекта ProLoader. Свойство contentLoaderInfo задается для действительного объекта ProLoaderInfo, даже если содержимое еще не загружено, чтобы можно было добавить прослушиватели событий объекта перед загрузкой.
Чтобы обнаружить неперехваченные ошибки, которые происходят в загруженном SWF, используйте свойство ProLoader.uncaughtErrorEvents, а не свойство ProLoader.contentLoaderInfo.uncaughtErrorEvents.
Примечание. Свойство contentLoaderInfo возвращает объект ProLoaderInfo. Класс ProLoaderInfo не является подклассом класса LoaderInfo и, следовательно, не предоставляет преимуществ неявного приведения к суперклассу. В связи с этим необходимо убедиться в том, что декларации типов были изменены с класса LoaderInfo на ProLoaderInfo.
Реализация
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | свойство |
uncaughtErrorEvents:EventDispatcher [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.0 |
Объект, который отправляет событие uncaughtError при возникновении необработанной ошибки в коде SWF-файла данного объекта ProLoader. Неперехваченные ошибки возникают, когда ошибка выдается за пределами блока try..catch или когда отправляется объект ErrorEvent, для которого не зарегистрирован прослушиватель.
Это свойство создается после завершения загрузки SWF-файла, связанного с данным объектом. До тех пор свойство uncaughtErrorEvents имеет значение null. В проекте, созданном с использованием только ActionScript, это свойство можно получить во время или после выполнения функции-конструктора основного класса файла SWF.
При обращении к этому свойству ProLoader в проигрывателе, который не поддерживает его, появляется ошибка. Возвращает объект EventDispatcher вместо объекта UncaughtErrorEvents во избежание появления ошибок в неподдерживающих проигрывателях.
Реализация
public function get uncaughtErrorEvents():EventDispatcherСвязанные элементы API
ProLoader | () | Конструктор |
public function ProLoader()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Создает объект ProLoader, с помощью которого можно загружать файлы таких форматов, как SWF, JPEG, GIF или PNG. Вызовите метод load(), чтобы загрузить ресурс в качестве дочернего объекта экземпляра ProLoader. После этого можно добавить объект ProLoader в список отображения (например, с помощью метода addChild() экземпляра DisplayObjectContainer). Ресурс отображается в рабочей области по мере загрузки.
Экземпляр ProLoader можно также использовать автономно, то есть без добавления в контейнер объекта в списке отображения. В этом режиме экземпляр Loader может использоваться для загрузки SWF-файла, содержащего дополнительные модули приложения.
О завершении загрузки SWF-файла можно узнать, используя события объекта ProLoaderInfo, связанные со свойством contentLoaderInfo объекта ProLoader. На этом этапе можно выполнить код в модуле SWF-файла, чтобы инициализировать и запустить модуль. В автономном режиме экземпляр ProLoader можно использовать для загрузки SWF-файла, содержащего компоненты и мультимедийные ресурсы. О завершении загрузки компонентов можно узнать с помощью оповещений о событиях объекта ProLoaderInfo. На этом этапе приложение может начать использовать компоненты и мультимедийные ресурсы в библиотеке SWF-файла, создав экземпляры классов ActionScript 3.0 для их представления.
Чтобы узнать состояние объекта ProLoader, отслеживайте следующие события, которые объект ProLoaderInfo связал со свойством contentLoaderInfo объекта ProLoader.
- Событие
openпередается после начала загрузки. - Событие
ioErrorилиsecurityErrorпередается, если загрузка файла невозможна или если в процессе загрузки произошла ошибка. - Событие
progressотправляется постоянно по ходу загрузки файла. - Событие
completeпередается после завершения загрузки файла, но до того, как станут доступны методы и свойства загруженного фрагмента ролика. Если загруженный SWF-файл использует предварительную загрузку RSL, это событие отправляется после завершения предварительной загрузки RSL. В этот момент времени реальное содержимое доступно через свойствоcontent. - Событие
initпередается после того, как станут доступны свойства и методы загруженного SWF-файла, чтобы можно было приступать к работе с ним. Это событие передается перед обработчикомcomplete. В потоковых SWF-файлах событиеinitможет происходить намного раньше, чем событиеcomplete. Для большинства целей следует использовать обработчикinit. Если загруженный SWF-файл использует предварительную загрузку RSL, это событие отправляется после завершения предварительной загрузки RSL. В этот момент времени реальное содержимое доступно через свойствоcontent.
Связанные элементы API
close | () | метод |
public function close():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 1.0, Flash Player Player - 9 |
Отменяет операцию метода load(), выполняемую в настоящий момент для экземпляра ProLoader.
load | () | метод |
public function load(request:URLRequest, context:LoaderContext = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
Загружает SWF-, JPEG-, прогрессивные JPEG-, неанимированные GIF- или PNG-файлы в объект, являющийся дочерним для объекта ProLoader. Если загружается анимированный GIF-файл, отображается только первый кадр. Так как объект ProLoader может содержать только один дочерний объект, отправка последующего запроса load() прекращает обработку предыдущего, если он еще ожидает выполнения, и начинается новая загрузка.
Примечание. В AIR 1.5 и Flash Player 10 максимальный размер загруженного изображения составляет 8,191 пикселей в ширину или высоту, а общее количество пикселей не может превышать 16,777,215. (Т. е. если ширина загруженного изображения составляет 8,191 пикселей, его высота не может быть больше 2 048 пикселей.) В проигрывателе Flash Player 9 и более ранних версий, а также в AIR 1.1 и более ранних версий, это ограничение составляет 2 880 пикселей в высоту и 2 880 пикселей в ширину.
SWF-файл или изображение, загруженное в объект ProLoader наследует свойства положения, поворота и масштаба родительских экранных объектов объекта ProLoader.
Используйте метод unload() для удаления роликов или изображений, загруженных с помощью этого метода, или для отмены выполняемой операции загрузки.
Можно запретить использование SWF-файлом этого метода путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.
При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса ProLoader.
В приложении Flash Player 10 и более поздней версии при использовании типа содержимого multipart (например, multipart/form-data), в котором содержится загрузка (обозначена параметром filename в заголовке content-disposition в теле оператора POST), к операции POST применяются правила безопасности для загрузок:
- Операция POST должна быть выполнена в ответ на действие, инициированное пользователем, такое как щелчок мыши или нажатие клавиши.
- Если операция POST является междоменной (назначением операции POST не является сервер, на котором содержится SWF-файл, отправляющий запрос POST), целевой сервер должен предоставить файл политик URL, в котором разрешен междоменный доступ.
Кроме того, все объекты типа содержимого multipart должны иметь допустимый синтаксис (в соответствии со стандартом RFC2046). Если синтаксис является недопустимым, к операции POST применяются правила безопасности, действующие для загрузок.
Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность.
Параметры
request:URLRequest — Абсолютный или относительный URL-адрес загружаемого SWF-, JPEG-, GIF- или PNG-файла. Относительный путь должен относиться к главному SWF-файлу. Абсолютные URL-адреса должны содержать название протокола, например http:// или file:///. Имена файлов не должны содержать имена жестких дисков.
| |
context:LoaderContext (default = null)
Если параметр Полные сведения см. в описании свойств класса LoaderContext. |
События
asyncError: — Отправляется объектом contentLoaderInfo, если свойство LoaderContext.requestedContentParent было указано и невозможно добавить загруженное содержимое как дочерний объект к указанному контейнеру DisplayObjectContainer. Это могло произойти, если загруженное содержимое — flash.display.AVM1Movie или при вызове addChild() к requestedContentParent выдается ошибка.
| |
complete: — Передается объектом contentLoaderInfo по завершении загрузки файла. Событие complete всегда отправляется после события init.
| |
httpStatus: — Передается объектом contentLoaderInfo, когда совершается сетевой запрос по протоколу HTTP, а проигрыватель Flash Player может определить код состояния HTTP.
| |
init: — Передается объектом contentLoaderInfo когда становятся доступны свойства и методы загруженного SWF-файла. Событие init всегда предшествует событию complete.
| |
ioError: — Отправляется объектом contentLoaderInfo, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки.
| |
open: — Отправляется объектом contentLoaderInfo после начала операции загрузки.
| |
progress: — Отправляется объектом contentLoaderInfo по мере получения данных во время операции загрузки.
| |
securityError: — Отправляется объектом contentLoaderInfo, если SWF-файл в изолированной программной среде файловой системы пытается загрузить содержимое из изолированной программной среды сети и наоборот.
| |
securityError: — Отправленный contentLoaderInfo объект, если LoaderContext.requestedContentParent свойства были указаны и "песочница" системы защиты LoaderContext.requestedContentParent не имеет доступа к загруженному SWF.
| |
unload: — Отправляется объектом contentLoaderInfo при удалении загруженного объекта.
|
Выдает
IOError — Значением свойства digest объекта request не является null. Свойство digest объекта URLRequest следует задавать только при вызове метода URLLoader.load() во время загрузки SWZ-файла (компонент платформы Adobe).
| |
SecurityError — Значение для LoaderContext.securityDomain должно быть null или SecurityDomain.currentDomain. Оно говорит о том, что загруженный мультимедийный файл можно поместить только в его натуральную изолированную программную среду безопасности или в вашу собственную (для этого требуется файл политики).
| |
SecurityError — Для локальных SWF-файлов нельзя задавать для LoaderContext.securityDomain других значений, кроме null. Не разрешается импортировать нелокальные мультимедийные файлы в локальную изолированную программную среду или помещать другие локальные мультимедийные файлы в не собственную изолированную программную среду.
| |
SecurityError — Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).
| |
SecurityError — Если свойства applicationDomain или securityDomain параметра context передаются с запрещенного домена.
| |
SecurityError — Если локальный SWF-файл пытается использовать свойствоsecurityDomain параметра context.
| |
IllegalOperationError — Если свойство requestedContentParent параметра context является объектом ProLoader.
| |
IllegalOperationError — Если параметр LoaderContext.parameters устанавливается не равным null и имеет некоторые значения, отличные от типа String.
|
Связанные элементы API
loadBytes | () | метод |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Player 9 |
Выполняет загрузку из двоичных данных, которые хранятся в объекте ByteArray.
Метод loadBytes() является асинхронным. Прежде чем обращаться к свойствам загруженного объекта, необходимо дождаться события инициации.
При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса ProLoader.
Параметры
bytes:ByteArray — Объект ByteArray. Содержимое объекта ByteArray может иметь любой формат, поддерживаемый классом ProLoader: SWF, GIF, JPEG или PNG.
| |
context:LoaderContext (default = null)applicationDomain объекта LoaderContext; свойства checkPolicyFile и securityDomain объекта LoaderContext не применяются.
Если параметр Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность. |
События
asyncError: — Отправляется объектом contentLoaderInfo, если свойство LoaderContext.requestedContentParent было указано и невозможно добавить загруженное содержимое как дочерний объект к указанному контейнеру DisplayObjectContainer. Это могло произойти, если загруженное содержимое — flash.display.AVM1Movie или при вызове addChild() к requestedContentParent выдается ошибка.
| |
complete: — Отправляется объектом contentLoaderInfo после завершения операции. Событие complete всегда отправляется после события init.
| |
init: — Отправляется объектом contentLoaderInfo, когда становятся доступны свойства и методы загруженных данных. Событие init всегда предшествует событию complete.
| |
ioError: — Отправляется объектом contentLoaderInfo, когда среда выполнения не может выполнить синтаксический анализ данных в массиве байт.
| |
open: — Отправляется объектом contentLoaderInfo после начала операции.
| |
progress: — Отправляется объектом contentLoaderInfo при передаче данных в памяти.
| |
securityError: — Отправленный contentLoaderInfo объект, если LoaderContext.requestedContentParent свойства были указаны и "песочница" системы защиты LoaderContext.requestedContentParent не имеет доступа к загруженному SWF.
| |
unload: — Отправляется объектом contentLoaderInfo при удалении загруженного объекта.
|
Выдает
ArgumentError — Если свойство length объекта ByteArray меньше 0.
| |
IllegalOperationError — Если свойство checkPolicyFile или securityDomain параметра context имеет значение, отличное от 0.
| |
IllegalOperationError — Если свойство requestedContentParent параметра context является объектом ProLoader.
| |
IllegalOperationError — Если параметр LoaderContext.parameters устанавливается не равным null и имеет некоторые значения, отличные от типа String.
| |
SecurityError — Если переданное свойство applicationDomain параметраcontext находится на запрещенном домене.
| |
SecurityError — Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).
|
Связанные элементы API
loadFilePromise | () | метод |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 2.5, AIR 2.0, Flash Player 9 |
Загружает экземпляр IFilePromise через параметр promise. Тип параметра promise использует суперкласс Object вместо IFilePromise, чтобы избежать ошибок в других проигрывателях.
Метод loadFilePromise принимает объект IFilePromise и загружает бинарные данные. Если данные являются последовательным потоком, например видео, дождитесь событий инициализации или хода выполнения перед доступом к свойствам загруженного объекта. Или дождитесь события завершения, чтобы убедиться, что данные полностью загружены.
При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса ProLoader.
Параметры
promise:Object — Объект IFilePromise. Источник данных объекта может иметь любой формат файла, поддерживаемый классом ProLoader: SWF, GIF, JPEG или PNG.
| |
context:LoaderContext (default = null)applicationDomain объекта LoaderContext; свойства checkPolicyFile и securityDomain объекта LoaderContext не применяются.
Если параметр Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность. |
События
asyncError: — Отправляется объектом contentLoaderInfo, если свойство LoaderContext.requestedContentParent было указано и невозможно добавить загруженное содержимое как дочерний объект к указанному контейнеру DisplayObjectContainer. Это могло произойти, если загруженное содержимое — flash.display.AVM1Movie или при вызове addChild() к requestedContentParent выдается ошибка.
| |
complete: — Отправляется объектом contentLoaderInfo после завершения операции. Событие complete всегда отправляется после события init.
| |
init: — Отправляется объектом contentLoaderInfo, когда становятся доступны свойства и методы загруженных данных. Событие init всегда предшествует событию complete.
| |
ioError: — Отправляется объектом contentLoaderInfo, когда среде выполнения не удается проанализировать данные в источнике данных или невозможно прочитать поток источника данных.
| |
open: — Отправляется объектом contentLoaderInfo после начала операции.
| |
progress: — Отправляется объектом contentLoaderInfo при передаче данных в памяти.
| |
securityError: — Отправленный contentLoaderInfo объект, если LoaderContext.requestedContentParent свойства были указаны и "песочница" системы защиты LoaderContext.requestedContentParent не имеет доступа к загруженному SWF.
| |
unload: — Отправляется объектом contentLoaderInfo при удалении загруженного объекта.
Внимание! Попытка получить доступ к этому API-интерфейсу не из приложения AIR приведет к возникновению ошибки. |
Выдает
IllegalOperationError — Если свойство requestedContentParent параметра context является объектом ProLoader.
| |
IllegalOperationError — Если параметр LoaderContext.parameters устанавливается не равным null и имеет некоторые значения, отличные от типа String.
| |
ArgumentError — Если IFilePromise объект передавал, поскольку параметр - null
|
Связанные элементы API
unload | () | метод |
public function unload():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS5.5 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Удаляет дочерний объект этого объекта ProLoader, загруженный с помощью метода load(). Параметр property связанного объекта ProLoaderInfo сброшен до значения null. Дочерний объект не обязательно удаляется, так как на него могут ссылаться другие объекты. Однако он больше не является дочерним для объекта ProLoader.
Перед загрузкой дочернего SWF-файла лучше всего явно закрыть все потоки объектов дочернего SWF-файла, таких как LocalConnection, NetConnection, NetStream и Sound. В противном случае в дочернем SWF-файле может продолжаться воспроизведение звука, несмотря на его загрузку. Чтобы закрыть потоки в дочернем SWF-файле, добавьте для него прослушиватель события unload. Когда родительский объект вызывает ProLoader.unload(), дочернему объекту отправляется событие unload. Следующий код показывает, как это делается.
function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}
myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z