Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
flash.display 

Loader  - AS3

Пакетыx

Верхний уровень
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Элементы языка

Глобальные константы
Глобальные функции
Операторы
Инструкции, ключевые слова и директивы
Специальные типы

Приложения

Новые возможности
Ошибки компилятора
Предупреждения компилятора
Ошибки времени выполнения
Миграция ActionScript 3
Поддерживаемые наборы символов
Только MXML
Элементы движения XML
Теги Timed Text
устаревший_индекс
Константы реализации специальных возможностей
Использование примеров
Юридическая информация
Пакетflash.display
Классpublic class Loader
НаследованиеLoader Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Подклассы AVLoader, FlexLoader

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

Класс Loader используется для загрузки SWF-файлов либо файлов изображений (JPG, PNG или GIF). Используйте метод load() для инициации загрузки. Загруженный экранный объект добавляется в качестве дочернего объекта для объекта Loader.

Используйте класс URLLoader для загрузки текстовых или двоичных данных.

Класс Loader переопределяет следующие наследуемые методы, так как объект Loader может иметь только один дочерний объект отображения — объект, загруженный им. При вызове следующих методов создается исключение: addChild(), addChildAt(), removeChild(), removeChildAt() и setChildIndex(). Для удаления загруженного объекта отображения необходимо удалить объект Loader из дочернего массива родительского объекта DisplayObjectContainer.

Замечания для iOS

В приложениях AIR для iOS SWF-файлы с кодом ActionScript можно загружать только из пакета приложения. Это ограничение относится ко всем элементам ActionScript, даже к ресурсам, имеющим имена классов для ActionScript. При загрузке любого SWF-файла необходимо указать тот же домен приложения, что и у родительского SWF, как показано в следующем примере:

 var loader:Loader = new Loader();
 var url:URLRequest = new URLRequest("swfs/SecondarySwf.swf");
 var loaderContext:LoaderContext = new LoaderContext(false, ApplicationDomain.currentDomain, null);
 loader.load(url, loaderContext);

Кроме того, в ОС iOS невозможно загрузить SWF-файл, который содержит один код ActionScript ByteCode (ABC), затем выгружает и не перезагружает его. При попытке сделать это среда выполнения выдает ошибку 3764.

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

AIR 3.7 и более поздних версий поддерживает загрузку размещенных на внешних ресурсах дополнительных SWF-файлов. Подробное описание этой возможности доступно здесь.

Эти ограничения системы iOS не действуют при запуске приложения в эмуляторе iOS (ipa-test-interpreter-simulator или ipa-debug-interpreter-simulator) или в режиме интерпретатора (ipa-test-interpreter или ipa-debug-interpreter).

Loader и безопасность

При использовании класса Loader необходимо продумать модель безопасности Flash Player и Adobe AIR.

  • Можно загружать содержимое из любого доступного источника.
  • Загрузка запрещена, если вызов SWF-файла осуществляется в изолированной программной среде сети, а файл для загрузки сохранен на локальном компьютере.
  • Если загружаемое содержимое является SWF-файлом, созданным с использованием ActionScript 3.0, его нельзя использовать вместе с SWF-файлом из другой изолированной программной среды безопасности, если не было разрешено перекрестное выполнение сценариев путем вызова метода System.allowDomain() или System.allowInsecureDomain() в загруженном файле.
  • Если загруженное содержимое является SWF-файлом версии AVM1 (написанным с использованием ActionScript 1.0 или 2.0), нельзя выполнять перекрестные сценарии совместно с SWF-файлом версии AVM2 (написанным на ActionScript 3.0). Однако можно передавать данные между двумя SWF-файлами с помощью класса LocalConnection.
  • Если загруженное содержимое является изображением, его данные не будут доступны для SWF-файлов за пределами изолированной программной среды безопасности, если домен этого SWF-файла не включен в файл политики URL-адресов на исходном домене изображения.
  • Фрагменты роликов в изолированной программной среде файловой системы не могут выполнять перекрестные сценарии вместе с фрагментами роликов в изолированной программной среде сети, и наоборот.
  • Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).

Однако в AIR эти ограничения по безопасности не распространяются на содержимое в изолированной программной среде безопасности application (содержимое, установленное с приложением AIR).

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

Возможно, при загрузке SWF-файла из ненадежного источника (такого как домен, не являющийся доменом корневого SWF-файла объекта Loader) потребуется определить маску для объекта Loader, чтобы предотвратить отрисовку загруженного содержимого (например, дочернего объекта объекта Loader) в областях рабочей области, находящихся за пределами этой маски, как показано в следующем коде:

 import flash.display.*;
 import flash.net.URLRequest;
 var rect:Shape = new Shape();
 rect.graphics.beginFill(0xFFFFFF);
 rect.graphics.drawRect(0, 0, 100, 100);
 rect.graphics.endFill();
 addChild(rect);
 var ldr:Loader = new Loader();
 ldr.mask = rect;
 var url:String = "http://www.unknown.example.com/content.swf";
 var urlReq:URLRequest = new URLRequest(url);
 ldr.load(urlReq);
 addChild(ldr);
 

Примечание. Компания Apple ввела в ОС iOS9 протокол защиты App Transport Security, который не позволяет устанавливать незащищенные подключения между приложением и веб-службами. По этой причине все подключения с незащищенных веб-сайтов, установленные с помощью Loader и URLLoader не смогут работать из-за протокола App Transport Security. Укажите исключения в поведении по умолчанию, добавляя ключи в файл Info.plist приложения.

Чтобы отключить функцию полностью, можно добавить в файл Info.plist следующие строки, чтобы все работало как раньше.

     <key>NSAppTransportSecurity</key>
               <dict>
                   <key>NSAllowsArbitraryLoads</key><true/>
               </dict>
  

Укажите исключения в поведении по умолчанию, добавляя ключи в тег InfoAdditions дескриптора приложения.

  <iPhone>
  <InfoAdditions>
                   <![CDATA[
                          <key>NSAppTransportSecurity</key>
                              <dict>
                                        <key>NSExceptionDomains</key>
                              <dict>
                                       <key>www.example.com</key>
                              <dict>
                                     <!--Include to allow subdomains-->
                                     <key>NSIncludesSubdomains</key>
                                     <true/>
                                     <!--Include to allow HTTP requests-->
                                     <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
                                     <true/>
                                      <!--Include to specify minimum TLS version-->
                                      <key>NSTemporaryExceptionMinimumTLSVersion</key>
                                      <string>TLSv1.1</string>
                              </dict>
                              </dict>
                              </dict>
                  ]]>
         </InfoAdditions>
  </iPhone>
  

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

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



Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
 InheritedcacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true.
DisplayObject
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  content : DisplayObject
[только для чтения] Содержит корневой экранный объект SWF-файла или изображения (JPG, PNG или GIF), загруженного с помощью методов load() или loadBytes().
Loader
  contentLoaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, соответствующий загружаемому объекту.
Loader
 InheritedcontextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick.
InteractiveObject
 Inheritedfilters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.
DisplayObject
 InheritedfocusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.
InteractiveObject
 Inheritedheight : Number
Указывает высоту экранного объекта в пикселях.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
 InheritedmetaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4.
DisplayObject
 InheritedmouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода.
InteractiveObject
 InheritedmouseX : Number
[только для чтения] Указывает координату x мыши или курсора пользовательского ввода (в пикселях).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y мыши или курсора пользовательского ввода (в пикселях).
DisplayObject
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус.
InteractiveObject
 InheritednumChildren : int
[только для чтения] Возвращает число дочерних элементов данного объекта.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
 Inheritedroot : DisplayObject
[только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.
DisplayObject
 Inheritedrotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).
DisplayObject
 InheritedrotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру.
DisplayObject
 InheritedrotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера.
DisplayObject
 Inheritedscale9Grid : Rectangle
Текущая активная сетка масштабирования.
DisplayObject
 InheritedscaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах).
DisplayObject
 InheritedscaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах).
DisplayObject
 InheritedscaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
 Inherited    softKeyboard : String
Управляет внешним видом программной клавиатуры.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS).
InteractiveObject
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
 InheritedtextSnapshot : flash.text:TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
  uncaughtErrorEvents : UncaughtErrorEvents
[только для чтения] Объект, который отправляет событие uncaughtError при возникновении необработанной ошибки в SWF-файле, загруженном объектом Loader.
Loader
 Inheritedvisible : Boolean
Определяет видимость экранного объекта.
DisplayObject
 Inheritedwidth : Number
Указывает ширину экранного объекта в пикселях.
DisplayObject
 Inheritedx : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Создает объект Loader, с помощью которого можно загружать файлы, например: SWF, JPEG, GIF или PNG.
Loader
 Inherited
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point.
DisplayObjectContainer
  
Отменяет операцию выполняемого в данный момент метода load() для экземпляра класса Loader.
Loader
 Inherited
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.
DisplayObjectContainer
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для экземпляра DisplayObject child.
DisplayObjectContainer
 Inherited
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур.
DisplayObject
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные).
DisplayObject
 Inherited
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные).
DisplayObject
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
load(request:URLRequest, context:LoaderContext = null):void
Загружает SWF-, JPEG-, прогрессивные JPEG-, неанимированные GIF- или PNG-файлы в объект, являющийся дочерним для объекта Loader.
Loader
  
loadBytes(bytes:ByteArray, context:LoaderContext = null):void
Выполняет загрузку из двоичных данных, которые хранятся в объекте ByteArray.
Loader
  
    loadFilePromise(promise:IFilePromise, context:LoaderContext = null):void
Загружает экземпляр IFilePromise.
Loader
 Inherited
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными).
DisplayObject
 Inherited
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Вызывает виртуальную клавиатуру.
InteractiveObject
 Inherited
Изменяет положение существующего дочернего элемента в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта.
DisplayObjectContainer
 Inherited
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов.
DisplayObjectContainer
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
Удаляет дочерний объект этого объекта Loader, загруженный с помощью метода load().
Loader
  
Пытается выгрузить содержимое дочернего SWF-файла и прекращает выполнение команд из загруженных SWF-файлов.
Loader
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
 InheritedОтправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
 InheritedОтправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 InheritedОтправляется после того, как экранный объект перемещается в фокус.InteractiveObject
 InheritedОтправляется после того, как экранный объект теряет фокус.InteractiveObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
 InheritedОтправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания.InteractiveObject
 InheritedОтправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedЭто событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью клавиатуры.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется при прокрутке колеса мыши над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания.InteractiveObject
 InheritedОтправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop().InteractiveObject
 InheritedОтправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы.InteractiveObject
 InheritedОтправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта.InteractiveObject
 InheritedПостоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ.InteractiveObject
 InheritedОтправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag().InteractiveObject
 InheritedОтправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag().InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения.InteractiveObject
 Inherited
    proximityEnd
Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения.InteractiveObject
 InheritedОтправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения.InteractiveObject
 Inherited
    proximityOut
Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения.InteractiveObject
 InheritedОтправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения.InteractiveObject
 InheritedОтправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости).InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню.InteractiveObject
 InheritedОтправляется сразу после того, как программная клавиатура вызывается.InteractiveObject
 InheritedПередается немедленно перед тем, как программная клавиатура появляется на экране.InteractiveObject
 InheritedПередается немедленно после того, как программная клавиатура убирается с экрана.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabIndex объекта.InteractiveObject
 InheritedПередается, если пользователь вводит один или несколько символов текста.InteractiveObject
 InheritedОтправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера).InteractiveObject
 InheritedОтправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера).InteractiveObject
 InheritedОтправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
 InheritedОтправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном).InteractiveObject
Сведения о свойстве

content

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

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

Содержит корневой экранный объект SWF-файла или изображения (JPG, PNG или GIF), загруженного с помощью методов load() или loadBytes().



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

Выдает
SecurityError — Загруженный SWF-файл или файл изображения принадлежит изолированной программной среде безопасности, к которой у вас нет доступа. Чтобы избежать такой ситуации, при вызове метода load() или loadBytes() загружаемый SWF-файл должен вызвать метод Security.allowDomain() либо загружающий файл должен указать параметр loaderContext со свойством securityDomain в значении SecurityDomain.currentDomain.

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

contentLoaderInfo

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

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

Возвращает объект LoaderInfo, соответствующий загружаемому объекту. Объекты LoaderInfo совместно используются объектом Loader и загруженным объектом содержимого. Объект LoaderInfo предоставляет сведения о процессе загрузки и статистику по загружаемому файлу.

События, связанные с загрузкой, отправляются объектом LoaderInfo, на который ссылается свойство contentLoaderInfo объекта Loader. Свойство contentLoaderInfo задается для действительного объекта LoaderInfo, даже если содержимое еще не загружено, чтобы можно было добавить прослушиватели событий объекта перед загрузкой.

Чтобы обнаружить неперехваченные ошибки, которые происходят в загруженном SWF, используйте свойство Loader.uncaughtErrorEvents, а не Loader.contentLoaderInfo.uncaughtErrorEvents.



Реализация
    public function get contentLoaderInfo():LoaderInfo

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


Пример  ( Использование этого примера )
В следующем примере демонстрируется загрузка и размещение изображения в ActionScript 3.0 с использованием класса Loader и события complete свойства contentLoaderInfo объекта Loader. Пример предоставлен ActionScriptExamples.com.
var url:String = "http://www.helpexamples.com/flash/images/image2.jpg";
var urlRequest:URLRequest = new URLRequest(url);
var loader:Loader = new Loader();
loader.contentLoaderInfo.addEventListener(Event.COMPLETE, loader_complete);
loader.load(urlRequest);
addChild(loader);
 
function loader_complete(evt:Event):void {
    var target_mc:Loader = evt.currentTarget.loader as Loader;
    target_mc.x = (stage.stageWidth - target_mc.width) / 2;
    target_mc.y = (stage.stageHeight - target_mc.height) / 2;
}

uncaughtErrorEvents

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

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

Объект, который отправляет событие uncaughtError при возникновении необработанной ошибки в SWF-файле, загруженном объектом Loader. Неперехваченные ошибки возникают, когда ошибка выдается за пределами блока try..catch или когда отправляется объект ErrorEvent, для которого не зарегистрирован прослушиватель.

Обратите внимание, что свойство uncaughtErrorEvents объекта Loader отправляет события, которые передаются по восходящей цепочке через него, а не создаются им непосредственно. Оно никогда не отправляет событие uncaughtErrorEvent в фазе цели. Оно только отправляет события в фазах захвата и восхождения по цепочке. Чтобы обнаружить неперехваченную ошибку в текущем SWF (SWF-файле, в котором определен объект Loader), используйте свойство LoaderInfo.uncaughtErrorEvents.

Если содержимое, загруженное объектом Loader, является SWF-файлом версии AVM1 (ActionScript 2), неперехваченные ошибки в этом файле не приводят к отправке события uncaughtError.



Реализация
    public function get uncaughtErrorEvents():UncaughtErrorEvents

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


Пример  ( Использование этого примера )
Следующий пример демонстрирует использование обработчика для обнаружения неперехваченных ошибок в загруженном SWF-файле. В примере определяется обработчик событий uncaughtError для обнаружения неперехваченных ошибок.

В конструкторе код создает объект Loader и регистрирует прослушиватель события uncaughtError, отправляемого свойством uncaughtErrorEvents объекта Loader.

В методе uncaughtErrorHandler() код проверяет тип данных свойства error и реагирует соответствующим образом.

package
{
    import flash.display.Loader;
    import flash.display.Sprite;
    import flash.events.ErrorEvent;
    import flash.events.UncaughtErrorEvent;
    import flash.net.URLRequest;

    public class LoaderUncaughtErrorEventExample extends Sprite
    {
        private var ldr:Loader;
        
        public function LoaderUncaughtErrorEventExample()
        {
            ldr = new Loader();
            ldr.load(new URLRequest("child.swf"));
            ldr.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
        }
        
        private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
        {
            if (event.error is Error)
            {
                var error:Error = event.error as Error;
                // do something with the error
            }
            else if (event.error is ErrorEvent)
            {
                var errorEvent:ErrorEvent = event.error as ErrorEvent;
                // do something with the error
            }
            else
            {
                // a non-Error, non-ErrorEvent type was thrown and uncaught
            }
        }
    }
}
Сведения о конструкторе

Loader

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

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

Создает объект Loader, с помощью которого можно загружать файлы, например: SWF, JPEG, GIF или PNG. Вызовите метод load(), чтобы загрузить ресурс в качестве дочернего объекта экземпляра Loader. После этого можно добавить объект Loader в список отображения (например, с помощью метода addChild() экземпляра DisplayObjectContainer). Ресурс отображается в рабочей области по мере загрузки.

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

О завершении загрузки SWF-файла можно узнать, используя события объекта LoaderInfo, связанные со свойством contentLoaderInfo объекта Loader. На этом этапе можно выполнить код в модуле SWF-файла, чтобы инициализировать и запустить модуль. В автономном режиме экземпляр Loader можно использовать для загрузки SWF-файла, содержащего компоненты и мультимедийные ресурсы. О завершении загрузки компонентов можно узнать с помощью оповещений о событиях объекта LoaderInfo. На этом этапе приложение может начать использовать компоненты и мультимедийные ресурсы в библиотеке SWF-файла, создав экземпляры классов ActionScript 3.0 для их представления.

Чтобы узнать состояние объекта Loader, отслеживайте следующие события, которые объект LoaderInfo связал со свойством contentLoaderInfo объекта Loader.

  • Событие open передается после начала загрузки.
  • Событие ioError или securityError передается, если загрузка файла невозможна или если в процессе загрузки произошла ошибка.
  • Событие progress отправляется постоянно по ходу загрузки файла.
  • Событие complete передается после завершения загрузки файла, но до того, как станут доступны методы и свойства загруженного фрагмента ролика.
  • Событие init передается после того, как станут доступны свойства и методы загруженного SWF-файла, чтобы можно было приступать к работе с ним. Это событие передается перед обработчиком complete. В потоковых SWF-файлах событие init может происходить намного раньше, чем событие complete. Для большинства целей следует использовать обработчик init.

Примечания (только для iOS) В приложениях AIR для iOS SWF-файлы с кодом ActionScript можно загружать только из пакета приложения. Это ограничение относится ко всем элементам ActionScript, даже к ресурсам, имеющим имена классов для ActionScript. При загрузке любого SWF-файла необходимо указать тот же домен приложения, что и у родительского SWF.

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

Эти ограничения не действуют при запуске приложения в эмуляторе iOS (ipa-test-interpreter-simulator или ipa-debug-interpreter-simulator) или в режиме интерпретатора (ipa-test-interpreter или ipa-debug-interpreter).

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

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

close

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

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

Отменяет операцию выполняемого в данный момент метода load() для экземпляра класса Loader.

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

load

()метод 
public function load(request:URLRequest, context:LoaderContext = null):void

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

Загружает SWF-, JPEG-, прогрессивные JPEG-, неанимированные GIF- или PNG-файлы в объект, являющийся дочерним для объекта Loader. Если загружается анимированный GIF-файл, отображается только первый кадр. Так как объект Loader может содержать только один дочерний объект, отправка последующего запроса 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-файл или изображение, загруженное в объект Loader наследует свойства положения, поворота и масштаба родительских экранных объектов объекта Loader.

Используйте метод unload() для удаления роликов или изображений, загруженных с помощью этого метода, или для отмены выполняемой операции загрузки.

Можно запретить использование SWF-файлом этого метода путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

Замечания для iOS

В приложениях AIR для iOS SWF-файлы с кодом ActionScript можно загружать только из пакета приложения. Это ограничение относится ко всем элементам ActionScript, даже к ресурсам, имеющим имена классов для ActionScript. При загрузке любого SWF-файла необходимо указать тот же домен приложения, что и у родительского SWF, как показано в следующем примере:

     var loader:Loader = new Loader();
     var url:URLRequest = new URLRequest("swfs/SecondarySwf.swf");
     var loaderContext:LoaderContext = new LoaderContext(false, ApplicationDomain.currentDomain, null);
     loader.load(url, loaderContext);

Кроме того, в ОС iOS невозможно загрузить SWF-файл, который содержит один код ActionScript ByteCode (ABC), затем выгружает и не перезагружает его. При попытке сделать это среда выполнения выдает ошибку 3764.

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

Эти ограничения не действуют при запуске приложения в эмуляторе iOS (ipa-test-interpreter-simulator или ipa-debug-interpreter-simulator) или в режиме интерпретатора (ipa-test-interpreter или ipa-debug-interpreter).

Loader и безопасность

При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса Loader.

В приложении 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, имеющий свойства, которые определяют следующее:
  • нужно ли проверять наличие файла политики при загрузке объекта;
  • ApplicationDomain для загруженного объекта;
  • SecurityDomain для загруженного объекта.
  • ImageDecodingPolicy для загруженного объекта изображения

Если параметр context не задан или ссылается на несуществующий объект, загружаемое содержимое остается в собственном домене защиты.

Только для iOS: при вызове метода load() в среде AIR для iOS объект LoaderContext должен указывать на основной домен приложения (ApplicationDomain.currentDomain).

Полные сведения см. в описании свойств класса LoaderContext.


События
asyncError:AsyncErrorEvent — Отправляется объектом contentLoaderInfo, если свойство LoaderContext.requestedContentParent было указано и невозможно добавить загруженное содержимое как дочерний объект к указанному контейнеру DisplayObjectContainer. Это могло произойти, если загруженное содержимое — flash.display.AVM1Movie или при вызове addChild() к requestedContentParent выдается ошибка.
 
complete:Event — Передается объектом contentLoaderInfo по завершении загрузки файла. Событие complete всегда отправляется после события init.
 
httpStatus:HTTPStatusEvent — Передается объектом contentLoaderInfo, когда совершается сетевой запрос по протоколу HTTP, а проигрыватель Flash Player может определить код состояния HTTP.
 
init:Event — Передается объектом contentLoaderInfo когда становятся доступны свойства и методы загруженного SWF-файла. Событие init всегда предшествует событию complete.
 
ioError:IOErrorEvent — Отправляется объектом contentLoaderInfo, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки.
 
open:Event — Отправляется объектом contentLoaderInfo после начала операции загрузки.
 
progress:ProgressEvent — Отправляется объектом contentLoaderInfo по мере получения данных во время операции загрузки.
 
securityError:SecurityErrorEvent — Отправляется объектом contentLoaderInfo, если SWF-файл в изолированной программной среде файловой системы пытается загрузить содержимое из изолированной программной среды сети и наоборот.
 
securityError:SecurityErrorEvent — Отправленный contentLoaderInfo объект, если LoaderContext.requestedContentParent свойства были указаны и "песочница" системы защиты LoaderContext.requestedContentParent не имеет доступа к загруженному SWF.
 
unload:Event — Отправляется объектом 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 равно Loader.
 
IllegalOperationError — Если параметр LoaderContext.parameters устанавливается не равным null и имеет некоторые значения, отличные от типа String.
 
IllegalOperationError — В системе iOS, при попытке загрузить SWF-файл в домен приложения, отличный от основного.
 
IllegalOperationError — В системе iOS при попытке заново загрузить SWF-файл, уже загруженный, выгруженный и содержащий код ABC.
 
Error — В системе iOS, при попытке загрузить SWF-файл с кодом ActionScript не из пакета приложения. Эта ошибка не может быть перехвачена. Она вызывает диалоговое окно на экране приложения с заголовком Uncompiled ActionScript (Нескомпилированный ActionScript). В средах ранее AIR 3.6 эта ошибка возникает при попытке загрузить любой SWF-файл с кодом ActionScript: как внешний, так и входящий в состав пакета приложения.

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

loadBytes

()метод 
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void

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

Выполняет загрузку из двоичных данных, которые хранятся в объекте ByteArray.

Метод loadBytes() является асинхронным. Прежде чем обращаться к свойствам загруженного объекта, необходимо дождаться события инициации.

При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса Loader.

Примечание (только для iOS) В приложениях AIR для iOS SWF-файлы с кодом ActionScript можно загружать только из пакета приложения. Это ограничение относится ко всем элементам ActionScript, даже к ресурсам, имеющим имена классов для ActionScript. При загрузке любого SWF-файла необходимо указать тот же домен приложения, что и у родительского SWF.

В средах ранее AIR 3.6 данный метод не действует на платформе iOS.

Параметры

bytes:ByteArray — Объект ByteArray. Содержимое объекта ByteArray может иметь любой формат, поддерживаемый классом Loader: SWF, GIF, JPEG или PNG.
 
context:LoaderContext (default = null) — Объект LoaderContext. Применяется только свойство applicationDomain объекта LoaderContext; свойства checkPolicyFile и securityDomain объекта LoaderContext не применяются.

Если параметр context не задан или ссылается на несуществующий объект, содержимое загружается в текущий домен защиты — процесс, обозначенный как «загрузка-импорт» в документации о безопасности проигрывателя Flash Player. В частности, если загружаемый SWF-файл установил отношения доверия с удаленным SWF-файлом, встроив удаленный SWF-файл в свой код, то загружаемый SWF-файл может импортировать удаленный файл непосредственно в собственный домен защиты.

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


События
asyncError:AsyncErrorEvent — Отправляется объектом contentLoaderInfo, если свойство LoaderContext.requestedContentParent было указано и невозможно добавить загруженное содержимое как дочерний объект к указанному контейнеру DisplayObjectContainer. Это могло произойти, если загруженное содержимое — flash.display.AVM1Movie или при вызове addChild() к requestedContentParent выдается ошибка.
 
complete:Event — Отправляется объектом contentLoaderInfo после завершения операции. Событие complete всегда отправляется после события init.
 
init:Event — Отправляется объектом contentLoaderInfo, когда становятся доступны свойства и методы загруженных данных. Событие init всегда предшествует событию complete.
 
ioError:IOErrorEvent — Отправляется объектом contentLoaderInfo, когда среда выполнения не может выполнить синтаксический анализ данных в массиве байт.
 
open:Event — Отправляется объектом contentLoaderInfo после начала операции.
 
progress:ProgressEvent — Отправляется объектом contentLoaderInfo при передаче данных в памяти.
 
securityError:SecurityErrorEvent — Отправленный contentLoaderInfo объект, если LoaderContext.requestedContentParent свойства были указаны и "песочница" системы защиты LoaderContext.requestedContentParent не имеет доступа к загруженному SWF.
 
unload:Event — Отправляется объектом contentLoaderInfo при удалении загруженного объекта.

Выдает
ArgumentError — Если свойство length объекта ByteArray меньше 0.
 
IllegalOperationError — Если свойство checkPolicyFile или securityDomain параметра context имеет значение, отличное от 0.
 
IllegalOperationError — Если свойство requestedContentParent параметра context равно Loader.
 
IllegalOperationError — Если параметр LoaderContext.parameters устанавливается не равным null и имеет некоторые значения, отличные от типа String.
 
IllegalOperationError — В системе iOS, при попытке загрузить SWF-файл в домен приложения, отличный от основного.
 
IllegalOperationError — В системе iOS при попытке заново загрузить SWF-файл, уже загруженный, выгруженный и содержащий код ABC.
 
Error — В системе iOS, при попытке загрузить SWF-файл с кодом ActionScript не из пакета приложения. Эта ошибка не может быть перехвачена. Она вызывает диалоговое окно на экране приложения с сообщением Uncompiled ActionScript (Нескомпилированный ActionScript). В средах ранее AIR 3.6 эта ошибка возникает при попытке загрузить любой SWF-файл с кодом ActionScript: как внешний, так и входящий в состав пакета приложения.
 
SecurityError — Если переданное свойство applicationDomain параметраcontext находится на запрещенном домене.
 
SecurityError — Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).

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

    loadFilePromise

()метод 
public function loadFilePromise(promise:IFilePromise, context:LoaderContext = null):void

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2.5

Загружает экземпляр IFilePromise.

Метод loadFilePromise принимает объект IFilePromise и загружает бинарные данные. Если данные являются последовательным потоком, например видео, дождитесь событий инициализации или хода выполнения перед доступом к свойствам загруженного объекта. Или дождитесь события завершения, чтобы убедиться, что данные полностью загружены.

При использовании данного метода необходимо учесть модель безопасности проигрывателя Flash Player, рассмотренную в описании класса Loader.

Параметры

promise:IFilePromise — Объект IFilePromise. Источник данных объекта может иметь любой формат файла, поддерживаемый классом Loader: SWF, GIF, JPEG или PNG.
 
context:LoaderContext (default = null) — Объект LoaderContext. Применяется только свойство applicationDomain объекта LoaderContext; свойства checkPolicyFile и securityDomain объекта LoaderContext не применяются.

Если параметр context не задан или ссылается на несуществующий объект, содержимое загружается в текущий домен защиты — процесс, обозначенный как «загрузка-импорт» в документации о безопасности проигрывателя Flash Player. В частности, если загружаемый SWF-файл установил отношения доверия с удаленным SWF-файлом, встроив удаленный SWF-файл в свой код, то загружаемый SWF-файл может импортировать удаленный файл непосредственно в собственный домен защиты.

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


События
asyncError:AsyncErrorEvent — Отправляется объектом contentLoaderInfo, если свойство LoaderContext.requestedContentParent было указано и невозможно добавить загруженное содержимое как дочерний объект к указанному контейнеру DisplayObjectContainer. Это могло произойти, если загруженное содержимое — flash.display.AVM1Movie или при вызове addChild() к requestedContentParent выдается ошибка.
 
complete:Event — Отправляется объектом contentLoaderInfo после завершения операции. Событие complete всегда отправляется после события init.
 
init:Event — Отправляется объектом contentLoaderInfo, когда становятся доступны свойства и методы загруженных данных. Событие init всегда предшествует событию complete.
 
ioError:IOErrorEvent — Отправляется объектом contentLoaderInfo, когда среде выполнения не удается проанализировать данные в источнике данных или невозможно прочитать поток источника данных.
 
open:Event — Отправляется объектом contentLoaderInfo после начала операции.
 
progress:ProgressEvent — Отправляется объектом contentLoaderInfo при передаче данных в памяти.
 
securityError:SecurityErrorEvent — Отправленный contentLoaderInfo объект, если LoaderContext.requestedContentParent свойства были указаны и "песочница" системы защиты LoaderContext.requestedContentParent не имеет доступа к загруженному SWF.
 
unload:Event — Отправляется объектом contentLoaderInfo при удалении загруженного объекта.

Выдает
IllegalOperationError — Если свойство requestedContentParent параметра context равно Loader.
 
IllegalOperationError — Если параметр LoaderContext.parameters устанавливается не равным null и имеет некоторые значения, отличные от типа String.
 
ArgumentError — Если IFilePromise объект передавал, поскольку параметр - null

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

unload

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

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

Удаляет дочерний объект этого объекта Loader, загруженный с помощью метода load(). Параметр property связанного объекта LoaderInfo сброшен до значения null. Дочерний объект не обязательно удаляется, так как на него могут ссылаться другие объекты. Однако он больше не является дочерним для объекта Loader.

При вызове метода unload() свойство contentLoaderInfo объекта Loader принимает значение null. Все визуальные ресурсы, загруженные вместе с этим SWF, выгружаются из памяти. Определения классов ActionScript из загруженного SWF остаются в памяти, поэтому код в том домене приложения, куда был загружен SWF, может и далее получать доступ к экземплярам этих классов и создавать новые экземпляры.

Примечание (только для iOS). В средах ранее AIR 3.6 данный метод не действует на платформе iOS.

Перед загрузкой дочернего SWF-файла лучше всего явно закрыть все потоки объектов дочернего SWF-файла, таких как LocalConnection, NetConnection, NetStream и Sound. В противном случае в дочернем SWF-файле может продолжаться воспроизведение звука, несмотря на его загрузку. Чтобы закрыть потоки в дочернем SWF-файле, добавьте для него прослушиватель события unload. Когда родительский объект вызывает Loader.unload(), дочернему объекту отправляется событие unload. Следующий код показывает, как это делается.

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

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

unloadAndStop

()метод 
public function unloadAndStop(gc:Boolean = true):void

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Пытается выгрузить содержимое дочернего SWF-файла и прекращает выполнение команд из загруженных SWF-файлов. Данный метод пытается выгрузить SWF-файлы, загруженные при помощи метода Loader.load() или Loader.loadBytes(), удалив ссылки на объекты EventDispatcher, NetConnection, Timer, Sound или Video дочернего SWF-файла. В результате для дочернего файла SWF и его списка отображения выполняются следующие действия:

  • Останавливается воспроизведение звука.
  • Удаляются прослушиватели событий рабочей области.
  • Удаляются прослушиватели событий enterFrame, frameConstructed, exitFrame, activate и deactivate.
  • Останавливаются таймеры.
  • Отсоединяются экземпляры Camera и Microphone.
  • Прекращается воспроизведение видеороликов.

При вызове метода unloadAndStop() свойство contentLoaderInfo объекта Loader принимает значение null. Все визуальные ресурсы, загруженные вместе с этим SWF, выгружаются из памяти. Определения классов ActionScript из загруженного SWF остаются в памяти, поэтому код в том домене приложения, куда был загружен SWF, может и далее получать доступ к экземплярам этих классов и создавать новые экземпляры.

Примечание (только для iOS). В средах ранее AIR 3.6 данный метод не действует на платформе iOS.

Параметры

gc:Boolean (default = true) — Предоставляет инструкции для сборщика мусора относительно того, требуется (true) или не требуется (false) выполнять действия в дочерних объектах SWF. При асинхронной выгрузке нескольких объектов производительность приложения можно повысить, задав для параметра gc значение false. Однако, если для этого параметра задано значение false, мультимедийные объекты и экранные объекты дочернего SWF-файла могут остаться в памяти после выполнения команды unloadAndStop().

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

LoaderExample.as

В следующем примере класс LoaderExample служит для иллюстрации использования различных прослушивателей событий. Это можно сделать, выполнив следующие действия.
  1. Создается свойство url, описывающее местоположение и имя файла изображения.
  2. В конструкторе LoaderExample создается новый объект Loader с именем loader и затем передается методу configureListeners(), описанному в шаге 3.
  3. Конструктор создает новый экземпляр объекта URLRequest, request, и передает url, чтобы сообщить имя и местоположение файла.
  4. Объект request передается методу load() объекта loader для загрузки изображения в список отображения.
  5. Прослушиватель событий clickHandler зарегистрировал событие click для средства загрузки. После щелчка мыши загруженное изображение выгружается.
  6. Метод configureListeners() добавляет семь прослушивателей событий с помощью следующих методов:
    • Метод completeHandler() выполняется по завершении загрузки изображения.
    • Метод httpStatusHandler() выполняется, если изображение загружено не локально и только если доступен сетевой запрос и проигрыватель Flash Player может его обнаружить.
    • Метод initHandler() выполняется перед методом completeHandler() и после метода progressHandler(). Как правило, событие init более полезно при загрузке SWF-файлов.
    • Метод ioErrorHandler() выполняется, если файла изображения нет или он недоступен.
    • Метод openHandler() выполняется при первом открытии изображения.
    • Метод progressHandler() выполняется, когда начинается и когда заканчивается загрузка файла изображения.
    • Метод unLoadHandler() выполняется при выгрузке с использованием метода unload(), когда пользователь нажимает на изображение.

Необходимо учитывать следующие требования.

  • В этом примере требуется поместить файл с именем Image.gif в тот же каталог, что и компилированный SWF-файл. Используйте изображение, область которого соответствует размерам основного SWF-файла.
  • Хотя в этом примере используются все события, доступные для объекта LoaderInfo, в большинстве случаев требуется только та или иная подгруппа. В частности, при загрузке только файла изображения можно использовать только событие complete (и, возможно, событие ioError), если загружается локальное изображение.
package {
    import flash.display.Loader;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

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

        public function LoaderExample() {
            var loader:Loader = new Loader();
            configureListeners(loader.contentLoaderInfo);
            loader.addEventListener(MouseEvent.CLICK, clickHandler);

            var request:URLRequest = new URLRequest(url);
            loader.load(request);

            addChild(loader);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(Event.INIT, initHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(Event.UNLOAD, unLoadHandler);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function initHandler(event:Event):void {
            trace("initHandler: " + event);
        }

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

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler: bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function unLoadHandler(event:Event):void {
            trace("unLoadHandler: " + event);
        }

        private function clickHandler(event:MouseEvent):void {
            trace("clickHandler: " + event);
            var loader:Loader = Loader(event.target);
            loader.unload();
        }
    }
}




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

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