ActionScript 3.0 Версії середовища виконання: 1.0 9 Клас LoaderInfo забезпечує відомості про завантаження SWF-файлі або файлі зображення (JPEG, GIF або PNG). Об'єкти LoaderInfo доступні для будь-яких екранних об'єктів. Надана інформація включає процес завантаження, URL-адреси завантажує об'єкта і отриманий вміст, загальна кількість байт і номінальна висота і ширина вмісту.

Звернутися до об'єктів LoaderInfo можна двома способами:

• Властивість contentLoaderInfo об'єкта flash.display.Loader object- властивість contentLoaderInfo завжди є для об'єкта Loader. Якщо об'єкт Loader не викликав метод load () або loadBytes () або не додавав достатнього обсягу вмісту, спроба звернутися до багатьох властивостями contentLoaderInfo призведе до появи помилки.
• Властивість 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 завантаженого об'єкта.

Деякі властивості contentLoaderInfo об'єкта Loader залишаються недоступними аж до завершення завантаження. Але можна отримати такі властивості, як bytesLoaded, bytesTotal, url, loaderURL і applicationDomain. Коли об'єкт loaderInfo відправляє подія init, можна звернутися до всіх властивостей об'єкта loaderInfo і завантаженого зображення або SWF-файлу.

Примітка. Всі властивості об'єктів LoaderInfo доступні тільки для читання.

Метод EventDispatcher.dispatchEvent () не застосовний до об'єктів LoaderInfo. Якщо викликати метод dispatchEvent () для об'єкта LoaderInfo, з'явиться помилка IllegalOperationError.

Подивитися приклади

actionScriptVersion: uint [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 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 [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

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

Всі програмні коди в SWF-файлі визначені для існування в домені додатку. Поточним доменом додатки є домен, де виконується основне додаток. Системний домен містить всі домени додатків, включаючи поточний домен, і це означає, що він містить всі класи програвача Flash Player.

Всі домени додатків, крім системного, мають пов'язаний батьківський домен. Батьківським доменом властивості applicationDomain основного додатка є системний домен. Завантажені класи визначаються тільки в тому випадку, якщо вони вже не визначені в своїх батьківських класах. Не можна перезаписати визначення завантаженого класу новим визначенням.

Приклади використання доменів додатків см. В розділі "Среда клієнтської системи" керівництва Програмування на ActionScript 3.0.

Реалізація
public function get applicationDomain (): ApplicationDomain
видає
SecurityError - Ізольована програмне середовище безпеки даного викликає об'єкта не має доступу до даного домену додатків.

Див. також

bytes: ByteArray [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9.0.115.0

Байти, пов'язані з об'єктом LoaderInfo.

Реалізація
public function get bytes (): ByteArray
видає
SecurityError - Якщо об'єкт, який звертається до даного API-інтерфейсу, не може отримати доступ до завантаженого об'єкту через обмеження з безпеки. Це може відбуватися, наприклад, коли об'єкт Loader намагається звернутися до властивості contentLoaderInfo.content і не отримує права на доступ до завантаженого вмісту з міркувань безпеки.

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

bytesLoaded: uint [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

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

Реалізація
public function get bytesLoaded (): uint
bytesTotal: uint [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

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

До відправки першої події progress відповідним об'єктом Loader даного об'єкта LoaderInfo, bytesTotal має значення 0. Після відправки події progress об'єктом Loader bytesTotal відображає фактичну кількість байт для завантаження.

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

Див. також

childAllowsParent: Boolean [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Чи означає довірчі відносини з боку вмісту (дочірнього елемента) до завантажувача (батькові чи матері). Якщо нащадок має право доступу до предку, значення - true; в іншому випадку значення - false. Це властивість має значення true, якщо дочірній об'єкт викликав метод allowDomain () для надання права доступу батьківського домену або якщо в дочірньому домені завантажена політика URL-адрес, що надає доступ батьківського домену. Якщо нащадок і предок знаходяться в тому ж домені, це властивість має значення true.

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

Реалізація
public function get childAllowsParent (): Boolean
видає
Error - Видається виняток, якщо файл завантажений недостатньо для отримання запитуваної інформації. content: DisplayObject [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Завантажений об'єкт, пов'язаний з даним об'єктом LoaderInfo.

Реалізація
public function get content (): DisplayObject
видає
SecurityError - Якщо об'єкт, який звертається до даного API-інтерфейсу, не може отримати доступ до завантаженого об'єкту через обмеження з безпеки. Це може відбуватися, наприклад, коли об'єкт Loader намагається звернутися до властивості contentLoaderInfo.content і не отримує права на доступ до завантаженого вмісту з міркувань безпеки.

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

contentType: String [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Тип MIME завантаженого файлу. Має значення null, якщо файл завантажений недостатньо для того, щоб програвач Flash Player міг визначити тип. У наступному списку перераховані можливі значення.

• "Application / x-shockwave-flash"
• "Image / jpeg"
• "Image / gif"
• "Image / png"

Реалізація
public function get contentType (): String
frameRate: Number [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

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

Це значення може відрізнятися від фактично використаної частоти кадрів. Програвач Flash Player одночасно використовує одну частоту кадрів для всіх завантажених SWF-файлів. Вона визначається номінальною частотою кадрів основного SWF-файлу. Крім того, Flash Player може не досягати основної частоти кадрів, що залежить від апаратних засобів, синхронізації звуку і інших чинників.

Реалізація
public function get frameRate (): Number
видає
Error - Якщо файл завантажений недостатньо для отримання запитуваної інформації. Error - Якщо файл не є SWF-файлом. height: int [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Номінальна висота завантаженого файлу. Це значення може відрізнятися від фактичної висоти області відображення вмісту, так як масштаб завантаженого вмісту або його батьківських екранних об'єктів може змінюватися

Реалізація
public function get height (): int
видає
Error - Якщо файл завантажений недостатньо для отримання запитуваної інформації. loader: Loader [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 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: String [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

URL-адресу SWF-файлу, який запустив завантаження мультимедійного вмісту описаного в даному об'єкті LoaderInfo. Для екземпляра основного класу SWF-файлу цей URL-адресу збігається з власним URL-адресою цього файлу.

Реалізація
public function get loaderURL (): String
parameters: Object [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 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: Boolean [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Чи означає довірчі відносини з боку завантажувача (батьківського елемента) до вмісту (нащадку). Якщо предок має право доступу до нащадка, значення - true; в іншому випадку значення - false. Це властивість має значення true, якщо батьківський об'єкт викликав метод allowDomain () для надання права доступу дочірньому домену або якщо в батьківському домені завантажена політика URL-адрес, що надає доступ дочірньому домену. Якщо нащадок і предок знаходяться в тому ж домені, це властивість має значення true.

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

Реалізація
public function get parentAllowsChild (): Boolean
видає
Error - Видається виняток, якщо файл завантажений недостатньо для отримання запитуваної інформації. sameDomain: Boolean [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

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

Реалізація
public function get sameDomain (): Boolean
видає
Error - Видається виняток, якщо файл завантажений недостатньо для отримання запитуваної інформації. sharedEvents: EventDispatcher [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Примірник EventDispatcher, за допомогою якого можливий обмін подіями через зони з різним рівнем безпеки. Навіть коли завантажує і завантаження об'єкти не довіряють один одному, вони обидва можуть звертатися до sharedEvents.

Реалізація
public function get sharedEvents (): EventDispatcher
swfVersion: uint [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

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

Реалізація
public function get swfVersion (): uint
видає
Error - Якщо файл завантажений недостатньо для отримання запитуваної інформації. Error - Якщо файл не є SWF-файлом.

Див. також

url: String [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

URL-адресу завантаженого графічного вмісту.

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

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

Див. також

width: int [тільки для читання] Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Номінальна ширина завантаженого вмісту. Це значення може відрізнятися від фактичної ширини області відображення вмісту, так як масштаб завантаженого вмісту або його батьківських екранних об'єктів може змінюватися

Реалізація
public function get width (): int
видає
Error - Якщо файл завантажений недостатньо для отримання запитуваної інформації. public static function getLoaderInfoByDefinition (object: Object ): LoaderInfo Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9.0.115.0

Повертає об'єкт LoaderInfo, пов'язаний з SWF-файлом, певним в якості об'єкта.

параметри

object: Object - Об'єкт SWF-файлу. повертає LoaderInfo - Пов'язаний об'єкт LoaderInfo. Тип об'єкта події: flash.events.Event
властивість Event.type = flash.events.Event.COMPLETE
Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Відправляється після успішного завантаження даних. Іншими словами, ця подія відправляється при завершенні завантаження всього вмісту. Подія complete завжди відправляється після події init. Подія init відправляється, коли об'єкт стає доступним, хоча завантаження вмісту може тривати.

Константа Event.COMPLETE визначає значення властивості type об'єкта complete.

Дана подія має такі властивості.

Властивість Значення bubbles false cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. target Мережевий об'єкт, який завершив завантаження.

Див. також

Тип об'єкта події: flash.events.HTTPStatusEvent
властивість HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS
Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Відправляється, коли відбувається мережевий запит по протоколу HTTP, а програвач Flash Player може визначити код стану HTTP.

Константа HTTPStatusEvent.HTTP_STATUS визначає значення властивості type об'єкта події httpStatus.

Дана подія має такі властивості.

Властивість Значення bubbles false cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. status Код стану HTTP, повернутий сервером. target Мережевий об'єкт, який одержує код стану НТТР.

Див. також

Тип об'єкта події: flash.events.Event
властівість Event.type = flash.events.Event.INIT
Мова версії: ActionScript 3.0 Версії середовища Виконання: 1.0 9

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

• Доступні всі властивості і методи, пов'язані з завантаженим об'єктом і з об'єктом LoaderInfo.
• Завершена робота конструкторів для всіх дочірніх об'єктів.
• Код ActionScript в першому кадрі основний тимчасової шкали завантаженого SWF-файлу був повністю виконаний.

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

Подія init завжди передує події complete.

Константа Event.INIT визначає значення властивості typeоб'екта події init.

Дана подія має такі властивості.

Властивість Значення bubbles false cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. target Об'єкт LoaderInfo, пов'язаний з завантажуваних SWF-файлом.

Див. такоже

Тип об'єкта події: flash.events.IOErrorEvent
властивість IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR
Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Відправляється, коли відбувається помилка введення-виведення, що призводить до збою операції завантаження.

Задає значення властивості type для об'єкта події ioError.

Дана подія має такі властивості.

Властивість Значення bubbles false cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. target Мережевий об'єкт, з яким сталася помилка введення / виводу. text Текст, що відображається у вигляді повідомлення про помилку.

Див. такоже

Тип об'єкта події: flash.events.Event
властивість Event.type = flash.events.Event.OPEN
Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Відправляється при запуску операції завантаження.

Константа Event.OPEN визначає значення властивості type об'єкта події open.

Дана подія має такі властивості.

Властивість Значення bubbles false cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. target Мережевий об'єкт, який встановив підключення.

Див. такоже

Тип об'єкта події: flash.events.ProgressEvent
властивість ProgressEvent.type = flash.events.ProgressEvent.PROGRESS
Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Відправляється в разі отримання даних в ході операції завантаження.

Задає значення властивості type для об'єкта події progress.

Дана подія має такі властивості.

Властивість Значення bubbles false bytesLoaded Число елементів або байт, завантажених на момент обробки події Прослуховувач. bytesTotal Загальна кількість елементів або байт, які в підсумку будуть отримані в разі успішного завершення завантаження. cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. target Мережевий об'єкт, який повідомляє відомості про прогрес.

Див. такоже

Тип об'єкта події: flash.events.Event
властивість Event.type = flash.events.Event.UNLOAD
Мова версії: ActionScript 3.0 Версії середовища виконання: 1.0 9

Відправляється об'єктом LoaderInfo кожен раз, коли завантажений об'єкт видаляється з допомогою методу unload () об'єкта Loader, а також коли виконується перезавантаження тим же об'єктом Loader, і перед початком завантаження видаляється початковий вміст.

Константа Event.UNLOAD визначає значення властивості type об'єкта події unload.

Дана подія має такі властивості.

Властивість Значення bubbles false cancelable false; немає поведінки за замовчуванням для скасування. currentTarget Об'єкт, активно обробляє об'єкт Event за допомогою Прослуховувач подій. target Об'єкт LoaderInfo, пов'язаний з вивантажують або замінним SWF-файлом.

Див. такоже

У наступному прикладі клас 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); }}}