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

RSLInfo  - AS3 Flash

Пакетfl.rsl
Классpublic class RSLInfo
НаследованиеRSLInfo Inheritance EventDispatcher Inheritance Object
Подклассы SWZInfo

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

Класс RSLInfo позволяет задать использование файлов RSL (файлы общих библиотек среды выполнения). Можно добавить несколько URL (как для SWF-файла, так и для необходимого файла политики) с помощью метода addEntry(). Класс RSLInfo может отправлять любое из этих событий: Event.COMPLETE, IOErrorEvent.IO_ERROR, SecurityErrorEvent.SECURITY_ERROR и ProgressEvent.PROGRESS. В результате использования резервных вариантов, даже в случае отправки событий SecurityErrorEvents или IOErrorEvents, загрузка RSL не завершается ошибкой, пока свойство failed не вернет значение true.

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



Общедоступные свойства
 СвойствоОпределено
  bytesLoaded : int
[только для чтения] Указывает число байтов, загруженных на данный момент, из всех загружаемых файлов.
RSLInfo
  bytesTotal : int
[только для чтения] Указывает общее число байтов, загруженных на данный момент, из всех загружаемых файлов.
RSLInfo
  complete : Boolean
[только для чтения] Возвращает значение true, если загрузка завершилась успешно, и false, если загрузка еще не закончена или завершилась ошибкой.
RSLInfo
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  currentAttemptIndex : int
[только для чтения] Возвращает индекс URL, загрузка которого предпринимается в данный момент.
RSLInfo
  failed : Boolean
[только для чтения] Возвращает значение true, если загрузка завершилась неудачно, и false, если загрузка еще не закончена или завершилась успешно.
RSLInfo
  loader : Loader
[только для чтения] Возвращает объект Loader, использованный для загрузки RSL.
RSLInfo
  policyFileURLs : Array
[только для чтения] Возвращает массив URL файлов политик, которые были добавлены с помощью addEntry().
RSLInfo
  rslURLs : Array
[только для чтения] Возвращает массив URL файлов RSL, добавленных с помощью addEntry().
RSLInfo
Общедоступные методы
 МетодОпределено
  
Конструктор.
RSLInfo
  
addEntry(url:String, policyFileURL:String = null):void
Добавляет последовательность URL (для файлов RSL и файлов политик).
RSLInfo
 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
  
Начинает загрузку RSL.
RSLInfo
 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
Сведения о свойстве

bytesLoaded

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

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

Указывает число байтов, загруженных на данный момент, из всех загружаемых файлов. Поскольку некоторые загрузки могут завершиться ошибкой и перейти на резервный URL, значение bytesLoaded может увеличиться или уменьшиться на протяжении времени. Индикаторы хода выполнения должны компенсировать это, чтобы избежать перемещения назад.



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

bytesTotal

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

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

Указывает общее число байтов, загруженных на данный момент, из всех загружаемых файлов. Поскольку некоторые загрузки могут завершиться ошибкой и перейти на резервный URL, значение bytesTotal может увеличиться или уменьшиться на протяжении времени. Индикаторы хода выполнения должны компенсировать это, чтобы избежать перемещения назад.



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

complete

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

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

Возвращает значение true, если загрузка завершилась успешно, и false, если загрузка еще не закончена или завершилась ошибкой.



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

currentAttemptIndex

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

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

Возвращает индекс URL, загрузка которого предпринимается в данный момент. При получении события ошибки это индекс URL, который не удалось загрузить. Индекс принадлежит к массивам policyFileURLs и rslURLs. До начала загрузки индекс имеет значение -1, после завершения загрузки индекс равен длине массивов, поэтому рекомендуется выполнять проверку диапазонов, прежде чем использовать полученное значение для доступа к элементам массива URL.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEventListener(IOErrorEvent.IO_ERROR, handleErr);
         function handleErr(e:Event) {
         trace('error: ' + e);
         trace('on download of url: ' + info.rslURLs[info.currentAttemptIndex]);
         }
         



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

failed

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

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

Возвращает значение true, если загрузка завершилась неудачно, и false, если загрузка еще не закончена или завершилась успешно. Свойство failed не получает значение true, если не удалось загрузить только один URL и имеются резервные для последующей попытки.



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

loader

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

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

Возвращает объект Loader, использованный для загрузки RSL. Может иметь значение NULL. Экземпляр Loader создается после вызова метода load().



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

policyFileURLs

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

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

Возвращает массив URL файлов политик, которые были добавлены с помощью addEntry(). Этот массив предназначен только для чтения. Добавлять записи можно с помощью метода addEntry(). Непосредственное редактирование этого массива дает непредсказуемые результаты.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.policyFileURLs.length; i++) {
            trace('url: ' + info.policyFileURLs[i]);
         }
         



Реализация
    public function get policyFileURLs():Array

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

rslURLs

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

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

Возвращает массив URL файлов RSL, добавленных с помощью addEntry(). Этот массив предназначен только для чтения. Добавлять записи можно с помощью метода addEntry(). Непосредственное редактирование этого массива дает непредсказуемые результаты.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.rslURLs.length; i++) {
            trace('url: ' + info.rslURLs[i]);
         }
         



Реализация
    public function get rslURLs():Array

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

Сведения о конструкторе

RSLInfo

()Конструктор
public function RSLInfo()

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

Конструктор.

Сведения о методе

addEntry

()метод
public function addEntry(url:String, policyFileURL:String = null):void

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

Добавляет последовательность URL (для файлов RSL и файлов политик). Порядок добавления URL зависит от их приоритета загрузки. Сначала выполняется попытка загрузки первого URL, попытка загрузки второго URL предпринимается только после получения ошибки для первого и т.д. Файлы политик добавляются, только когда загружен URL соответствующего файла RSL.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEntry('rsl.swf');
         myPreloader.addRSLInfo(info);
         myPreloader.start();
         

Параметры

url:String
 
policyFileURL:String (default = null)

load

()метод 
public function load():void

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

Начинает загрузку RSL. Первая запись загружается в первую очередь. Последующие записи используются в качестве резервных и загружаются в случае ошибки.





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

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