| Пакет | flash.html |
| Класс | public class HTMLLoader |
| Наследование | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Подклассы | FlexHTMLLoader |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах, но не поддерживается на мобильных устройствах или в средах AIR для телевизионных устройств. Используйте свойство HTMLLoader.isSupported, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
На настольных компьютерах (в профилях рабочего стола и расширенного рабочего стола) класс HTMLLoader использует внутренний модуль AIR WebKit. Доступные функции и внешний вид визуализации совпадают с аналогичными свойствами класса StageWebView в дополнение к тесной интеграции и связыванию сценариев ActionScript и JavaScript. Так как классом StageWebView используется системный веб-элемент управления, предоставляемый внешним модулем Flash Player, настоятельно не рекомендуется одновременно использовать экземпляры StageWebView и HTMLLoader, поскольку такая операция имеет непредсказуемые последствия и может привести к завершению работы приложения.
Размером по умолчанию объекта HTMLLoader является 0 x 0 пикселей. Задайте свойства width и height, чтобы сделать объект HTMLLoader видимым.
Максимальные размеры объекта HTMLLoader составляют 4 096 пикселов в высоту и 4 096 пикселов в ширину. Если для свойства width или height объекта HTMLLoader задать число, превышающее 4 095, объект HTMLLoader выдаст исключение ArgumentError. (Обратите внимание, что до версии AIR 2 максимальный размер объекта HTMLLoader составлял 2880 пикселей.)
Примечание. При отображении в прозрачном окне содержимое SWF, встроенное в HTML-страницу, должно иметь один из двух режимов wmode: transparent или opaque. Свойство wmode по умолчанию имеет значение window, поэтому если не задать нужное значение, содержимое SWF может не отображаться. В системах Windows и Linux содержимое SWF всегда отображается поверх другого содержимого, когда для свойства wmode задано значение window или opaque. Содержимое PDF не отображается в прозрачном окне независимо от используемого значения wmode.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| authenticate : Boolean
Задает обработку запросов аутентификации (true) или ее отсутствие (false) для запросов HTTP, отправленных этим объектом. | HTMLLoader | ||
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| cacheResponse : Boolean
Задает необходимость кэширования данных успешных ответов для запросов HTTP, отправленных этим объектом. | HTMLLoader | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| contentHeight : Number [только для чтения]
Высота содержимого HTML (в пикселях). | HTMLLoader | ||
| contentWidth : Number [только для чтения]
Ширина содержимого HTML (в пикселях). | HTMLLoader | ||
| contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
| doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен. | Sprite | |
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
| graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
| hasFocusableContent : Boolean [только для чтения]
Определяет, является ли какое-либо содержимое в объекте HTMLLoader фокусируемым. | HTMLLoader | ||
| height : Number [переопределить]
Задает высоту прямоугольника холста HTML, подлежащего визуализации. | HTMLLoader | ||
| historyLength : uint [только для чтения]
Полная длина списка журнала, включая предыдущие и последующие записи. | HTMLLoader | ||
| historyPosition : uint
Текущее положение в журнале. | HTMLLoader | ||
| hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
| htmlHost : flash.html:HTMLHost
Объект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title объекта HTMLLoader. | HTMLLoader | ||
| idleTimeout : Number
Указывает значение для времени ожидания активности (в миллисекундах) для запросов HTTP, отправленных данным объектом. | HTMLLoader | ||
| isSupported : Boolean [статические] [только для чтения]
Указывает, поддерживается ли класс HTMLLoader в клиентской системе. | HTMLLoader | ||
| loaded : Boolean [только для чтения]
Обозначает, было ли доставлено событие загрузки JavaScript, соответствующее предыдущему вызову метода load() или loadString(), в HTML DOM в объекте HTMLLoader. | HTMLLoader | ||
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| location : String [только для чтения]
Указатель URL для содержимого, загруженного в объект HTMLLoader. | HTMLLoader | ||
| manageCookies : Boolean
Задает необходимость управления стеком протоколов HTTP файлами cookie для данного объекта. | HTMLLoader | ||
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | |
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| navigateInSystemBrowser : Boolean
Задает, необходимо ли при переходе в корневом фрейме содержимого HTML (например, при переходе по ссылке, если задано свойство window.location, или вызове метода window.open()) выполнять переход в объекте HTMLLoader (false) или системном браузере по умолчанию (true). | HTMLLoader | ||
| needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | |
| numChildren : int [только для чтения]
Возвращает число дочерних элементов данного объекта. | DisplayObjectContainer | |
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| paintsDefaultBackground : Boolean
Определяет, является ли фон документа HTMLLoader белым непрозрачным (true) или нет (false). | HTMLLoader | ||
| parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
| pdfCapability : int [статические] [только для чтения]
Тип поддержки PDF в пользовательской системе, определенный как целочисленное кодовое значение. | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
Указывает, куда будет помещено содержимое, загруженное с помощью метода loadString(): в изолированную программную среду приложения (true) или в другую изолированную программную среду (false). | HTMLLoader | ||
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
| rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | DisplayObject | |
| rotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
| rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | DisplayObject | |
| runtimeApplicationDomain : ApplicationDomain
Программный домен, который необходимо использовать для объекта window.runtime в сценарии JavaScript на странице HTML. | HTMLLoader | ||
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
| scrollH : Number
Горизонтальное положение прокрутки содержимого HTML в объекте HTMLLoader. | HTMLLoader | ||
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| scrollV : Number
Вертикальное положение прокрутки содержимого HTML в объекте HTMLLoader. | HTMLLoader | ||
| softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| swfCapability : int [статические] [только для чтения]
Тип поддержки SWF в системе пользователя, представленный в виде целочисленного кода. | HTMLLoader | ||
| tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | DisplayObjectContainer | |
| tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | |
| tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
| textEncodingFallback : String
Кодировка символов, используемая содержимым HTMLLoader, если кодировка символов не задана страницей HTML. | HTMLLoader | ||
| textEncodingOverride : String
Кодировка символов, используемая в содержимом HTMLLoader, перезаписывает любой параметр на странице HTML. | HTMLLoader | ||
| textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
| useCache : Boolean
Задает необходимость обращения к локальному кэшу перед тем, как запросы HTTP, отправленные этим объектом, начнут извлекать данные. | HTMLLoader | ||
| useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
| userAgent : String
Строка агента пользователя, которую необходимо использовать в любых последующих запросах содержимого из данного объекта HTMLLoader. | HTMLLoader | ||
| visible : Boolean
Определяет видимость экранного объекта. | DisplayObject | |
| width : Number [переопределить]
Задает ширину прямоугольника холста HTML, подлежащего визуализации. | HTMLLoader | ||
| window : Object [только для чтения]
Глобальный объект JavaScript для содержимого, загруженного в управляющий элемент HTML. | HTMLLoader | ||
| x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject | |
| Метод | Определено | ||
|---|---|---|---|
Создает объект HTMLLoader. | HTMLLoader | ||
|
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
|
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | DisplayObjectContainer | |
Отменяет любую выполняющуюся операцию загрузки. | HTMLLoader | ||
|
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [статические]
Создает новый объект NativeWindow, который содержит объект HTMLLoader. | HTMLLoader | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | |
|
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
|
Возвращает позицию индекса для экземпляра DisplayObject child. | DisplayObjectContainer | |
Возвращает запись журнала в заданном положении. | HTMLLoader | ||
|
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
По возможности выполняет обратный переход в журнале браузера. | HTMLLoader | ||
По возможности выполняет переход вперед в журнале браузера. | HTMLLoader | ||
Выполняет переход на заданное число шагов в журнале браузера. | HTMLLoader | ||
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Загружает объект HTMLLoader с данными с узла, заданного параметром urlRequestToLoad. | HTMLLoader | ||
Загружает объект HTMLLoader с содержимым HTML в строке HTML. | HTMLLoader | ||
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Повторно загружает страницу из текущего положения. | HTMLLoader | ||
|
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Вызывает виртуальную клавиатуру. | InteractiveObject | |
|
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | DisplayObjectContainer | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
|
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | |
|
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | |
|
Завершает метод startDrag(). | Sprite | |
|
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | |
|
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | DisplayObjectContainer | |
|
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | DisplayObjectContainer | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
| Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
| Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Сигнализирует, что последняя операция загрузки, запрошенная методом loadString или load, завершена. | HTMLLoader | |||
| Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR. | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. | InteractiveObject | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
| Отправляется после того, как экранный объект перемещается в фокус. | InteractiveObject | ||
| Отправляется после того, как экранный объект теряет фокус. | InteractiveObject | ||
| [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
| Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания. | InteractiveObject | ||
| Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Сигнализирует, что одно или оба свойства contentWidth и contentHeight объекта HTMLLoader изменены. | HTMLLoader | |||
| Сигнализирует, что при выполнении операции загрузки создана модель HTML DOM. | HTMLLoader | |||
| Сигнализирует, что визуализация содержимого объекта HTMLLoader полностью обновлена. | HTMLLoader | |||
| Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | ||
| Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | ||
| Сигнализирует, что свойство location объекта HTMLLoader изменено. | HTMLLoader | |||
| Сигнализирует, что свойство location объекта HTMLLoader изменено. | HTMLLoader | |||
| Сигнализирует, что свойство location объекта HTMLLoader готово к изменению. | HTMLLoader | |||
| Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания. | InteractiveObject | ||
| Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop(). | InteractiveObject | ||
| Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы. | InteractiveObject | ||
| Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта. | InteractiveObject | ||
| Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ. | InteractiveObject | ||
| Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | ||
| Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. | InteractiveObject | ||
| Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости). | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
| Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
| [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
| Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
| Сигнализирует, что свойство scrollH или scrollV изменено объектом HTMLLoader. | HTMLLoader | |||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. | InteractiveObject | ||
| Отправляется сразу после того, как программная клавиатура вызывается. | InteractiveObject | ||
| Передается немедленно перед тем, как программная клавиатура появляется на экране. | InteractiveObject | ||
| Передается немедленно после того, как программная клавиатура убирается с экрана. | InteractiveObject | ||
| Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | ||
| Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | ||
| Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | ||
| Передается, если пользователь вводит один или несколько символов текста. | InteractiveObject | ||
| Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | ||
| Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | ||
| Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Сигнализирует, что в объекте HTMLLoader создано необрабатываемое исключение JavaScript. | HTMLLoader | |||
authenticate | свойство |
authenticate:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Задает обработку запросов аутентификации (true) или ее отсутствие (false) для запросов HTTP, отправленных этим объектом. Если задано значение false, при выполнении заданий аутентификации возвращается ошибка HTTP.
Значением по умолчанию является initialized from URLRequestDefaults.authenticate.
Реализация
public function get authenticate():Boolean public function set authenticate(value:Boolean):voidСвязанные элементы API
cacheResponse | свойство |
cacheResponse:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Задает необходимость кэширования данных успешных ответов для запросов HTTP, отправленных этим объектом. Если задано значение true, в объекте HTMLLoader используется кэш HTTP операционной системы.
Значением по умолчанию является initialized from URLRequestDefaults.cacheResponse.
Реализация
public function get cacheResponse():Boolean public function set cacheResponse(value:Boolean):voidСвязанные элементы API
contentHeight | свойство |
contentHeight:Number [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Высота содержимого HTML (в пикселях). Это свойство можно изменить аналогичным изменению размеров объекта HTMLLoader способом. Например, на странице HTML часто используется полное значение высоты объекта HTMLLoader, и свойство contentHeight может измениться при изменении высоты объекта HTMLLoader.
Реализация
public function get contentHeight():Number contentWidth | свойство |
contentWidth:Number [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Ширина содержимого HTML (в пикселях). Это свойство можно изменить аналогичным изменению размеров объекта HTMLLoader способом. Например, на странице HTML часто используется полное значение ширины объекта HTMLLoader, и свойство contentWidth может измениться при изменении ширины объекта HTMLLoader.
Реализация
public function get contentWidth():Number hasFocusableContent | свойство |
height | свойство |
height:Number[переопределить] | Версии среды выполнения: | AIR 1.0 |
Задает высоту прямоугольника холста HTML, подлежащего визуализации. Это свойство обозначает высоту экранного объекта HTMLLoader в пикселах. Максимальное значение свойства height составляет 4 095 пикселов. При изменении этого свойства в объекте HTMLLoader выполняется повторная визуализация документа HTML. Диспетчеризация событий htmlBoundsChanged может выполняться при изменении этого свойства.
При настройке свойства width или height объекта HTMLLoader границы объекта изменяются, но содержимое не масштабируется (так же происходит с другими типами экранных объектов).
Реализация
override public function get height():Number override public function set height(value:Number):void historyLength | свойство |
historyLength:uint [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Полная длина списка журнала, включая предыдущие и последующие записи. Для этого свойства установлено такое же значение, что и для свойства window.history.length JavaScript страницы HTML.
Реализация
public function get historyLength():uintСвязанные элементы API
historyPosition | свойство |
historyPosition:uint| Версии среды выполнения: | AIR 1.0 |
Текущее положение в журнале. Список журнала соответствует объекту window.history страницы HTML. Записи, расположенные перед текущим положением, называются предыдущим списком; записи после текущего положения называются последующим списком. При попытке настроить положение после конечных записей задается положение в конце списка.
Реализация
public function get historyPosition():uint public function set historyPosition(value:uint):voidСвязанные элементы API
htmlHost | свойство |
htmlHost:flash.html:HTMLHost| Версии среды выполнения: | AIR 1.0 |
Объект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title объекта HTMLLoader. Для переопределения поведения по умолчанию объекта HTMLLoader создайте подкласс класса HTMLHost и переопределите функции его членов для обработки различных изменений пользовательского интерфейса в содержимом HTML.
Реализация
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):voidСвязанные элементы API
idleTimeout | свойство |
idleTimeout:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2 |
Указывает значение для времени ожидания активности (в миллисекундах) для запросов HTTP, отправленных данным объектом.
Время ожидания покоя — это количество времени, в течение которого клиент ожидает ответ от сервера после установки подключения до прерывания обработки запроса.
Значением по умолчанию является initialized from URLRequestDefaults.idleTimeout.
Реализация
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidСвязанные элементы API
isSupported | свойство |
loaded | свойство |
loaded:Boolean [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Обозначает, было ли доставлено событие загрузки JavaScript, соответствующее предыдущему вызову метода load() или loadString(), в HTML DOM в объекте HTMLLoader. Это свойство имеет значение true перед передачей отправкой complete. Настройка для этого свойства значения true может быть невозможна. Причины аналогичны тем, по которым невозможно выполнить диспетчеризацию события complete.
Реализация
public function get loaded():Boolean location | свойство |
manageCookies | свойство |
manageCookies:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Задает необходимость управления стеком протоколов HTTP файлами cookie для данного объекта. Если задано значение true, файлы cookie добавляются в запрос, а файлы cookie, содержащиеся в ответе, сохраняются. Если задано значение false, файлы cookie не добавляются в запрос, а файлы cookie, содержащиеся в ответе, не сохраняются.
Значением по умолчанию является initialized from URLRequestDefaults.manageCookies.
Реализация
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):voidСвязанные элементы API
navigateInSystemBrowser | свойство |
navigateInSystemBrowser:Boolean| Версии среды выполнения: | AIR 1.0 |
Задает, необходимо ли при переходе в корневом фрейме содержимого HTML (например, при переходе по ссылке, если задано свойство window.location, или вызове метода window.open()) выполнять переход в объекте HTMLLoader (false) или системном браузере по умолчанию (true). При необходимости выполнения всех переходов в системном браузере (а не в объекте HTMLLoader) настройте для этого свойства значение true.
Значением по умолчанию является false.
Реализация
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | свойство |
paintsDefaultBackground:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Определяет, является ли фон документа HTMLLoader белым непрозрачным (true) или нет (false). Если для этого свойства задано значение false, в объекте HTMLLoader используются контейнер экранного объекта в качестве фона для содержимого HTML и свойство непрозрачности (значение alpha) контейнера экранного объекта в качестве фона содержимого HTML. Однако, если для элемента body или любого другого элемента документа HTML настроен непрозрачный цвет фона (может быть определен строкой style="background-color:gray"), для части представленного содержимого HTML используется заданный непрозрачный цвет фона.
Реализация
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | свойство |
pdfCapability:int [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Тип поддержки PDF в пользовательской системе, определенный как целочисленное кодовое значение. Содержимое PDF можно отобразить в объекте HTMLLoader только если для этого свойства задано значение PDFCapability.STATUS_OK. Класс PDFCapability определяет константы для возможных значений свойства pdfCapability, как показано ниже:
| Константа PDFCapability | Значение |
|---|---|
STATUS_OK | Необходимая версия (8.1 или более поздняя) приложения Acrobat или Adobe Reader обнаружена, и содержимое PDF можно загрузить в объект HTMLLoader.
Примечание. Если в системе Windows в настоящее время запущено приложение Acrobat или Adobe Reader версии 7.x или более поздней версии, используется эта версия, даже если установлена более поздняя версия, поддерживающая загрузку содержимого PDF, загруженного в объект HTMLLoader. В этом случае, если для свойства |
ERROR_INSTALLED_READER_NOT_FOUND | Версия Acrobat или Adobe Reader не обнаружена. Объекту HTMLLoader не удается отобразить содержимое PDF. |
ERROR_INSTALLED_READER_TOO_OLD | Приложение Acrobat или Adobe Reader обнаружено, но версия является слишком старой. Объекту HTMLLoader не удается отобразить содержимое PDF. |
ERROR_PREFERED_READER_TOO_OLD | Необходимая версия (8.1 или более поздняя) приложения Acrobat или Adobe Reader обнаружена, однако версия, настроенная для обработки содержимого PDF, является более ранней, чем 8.1. Объекту HTMLLoader не удается отобразить содержимое PDF. |
Реализация
public static function get pdfCapability():intСвязанные элементы API
placeLoadStringContentInApplicationSandbox | свойство |
placeLoadStringContentInApplicationSandbox:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Указывает, куда будет помещено содержимое, загруженное с помощью метода loadString(): в изолированную программную среду приложения (true) или в другую изолированную программную среду (false).
Если это свойство принимает значение false, содержимое, загруженное с помощью метода loadString(), помещается в изолированную программную среду, отличную от среды приложения, которая имеет перечисленные ниже особенности.
- Она позволяет загружать содержимое из сети (но не из файловой системы).
- Она не позволяет загружать данные с помощью XMLHttpRequest.
- Свойство
window.locationимеет значениеabout:blank. - Содержимое в такой изолированной программной среде не имеет доступа к свойству
window.runtime.
Если это свойство имеет значение true, содержимое, загруженное с помощью метода loadString(), помещается в изолированную программную среду приложения и имеет доступ к свойству window.runtime и ко всем API-интерфейсам AIR. Необходимо сделать источник данных для строки, используемой в вызове метода loadString(), доверенным. Кодовые инструкции в строке HTML выполняются с применением всех привилегий приложения, если это свойство имеет значение true. Это свойство стоит устанавливать на значение true, только если вы уверены, что строка не содержит вредоносного кода.
В приложениях, скомпилированных с помощью комплектов SDK AIR 1.0 или AIR 1.1, содержимое, загруженное с помощью метода loadString(), помещается в изолированную программную среду приложения.
Значением по умолчанию является false.
Реализация
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):voidСвязанные элементы API
runtimeApplicationDomain | свойство |
runtimeApplicationDomain:ApplicationDomain| Версии среды выполнения: | AIR 1.0 |
Программный домен, который необходимо использовать для window.runtime в сценарии JavaScript на странице HTML.
Если значение равно null или если HTML-содержимое происходит из домена защиты, отличного от домена защиты SWF-содержимого, содержащего объект HTMLLoader, для страницы используется домен приложений по умолчанию.
Реализация
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):voidВыдает
SecurityError — если объект ApplicationDomain находится в защищенном домене, отличном от домена вызывающего метода.
|
Связанные элементы API
scrollH | свойство |
scrollV | свойство |
swfCapability | свойство |
swfCapability:int [только для чтения] | Версии среды выполнения: | AIR 2 |
Тип поддержки SWF в системе пользователя, представленный в виде целочисленного кода. Содержимое SWF можно отобразить в объекте HTMLLoader, только если для этого свойства задано значение PDFCapability.STATUS_OK. Класс HTMLSWFCapability определяет константы для возможных значений свойства swfCapability, как показано ниже:
| Константа HTMLSWFCapability | Значение |
|---|---|
STATUS_OK | Обнаружена допустимая версия Adobe Flash Player, и содержимое SWF может быть загружено в объект HTMLLoader. |
ERROR_INSTALLED_PLAYER_NOT_FOUND | Не обнаружено ни одной версии Adobe Flash Player. Объекту HTMLLoader не удается отобразить содержимое SWF. |
ERROR_INSTALLED_PLAYER_TOO_OLD | Приложение Adobe Flash Player обнаружено, но его версия устарела. Объекту HTMLLoader не удается отобразить содержимое SWF. |
Реализация
public static function get swfCapability():intСвязанные элементы API
textEncodingFallback | свойство |
textEncodingFallback:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Кодировка символов, используемая содержимым HTMLLoader, если кодировка символов не задана страницей HTML. На странице HTML кодировка символов задается в теге meta, как показано ниже:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Значения указаны в списке действительных наборов символов IANA.
Если кодировка не задана страницей HTML, свойством textEncodingFallback или свойством textEncodingOverride, в содержимом HTML используется кодировка ISO-8859-1.
Реализация
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):voidСвязанные элементы API
textEncodingOverride | свойство |
textEncodingOverride:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Кодировка символов, используемая в содержимом HTMLLoader, перезаписывает любой параметр на странице HTML. На странице HTML кодировка символов задается в теге meta, как показано ниже:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Этот параметр также перезаписывает любой параметр в свойстве textEncodingFallback.
Значения указаны в списке действительных наборов символов IANA.
Настройте свойство textEncodingOverride после загрузки содержимого HTML для выполнения обновления AIR содержимого HTML с использованием заданной кодировки. После выполнения перехода к новой странице в объекте HTMLLoader необходимо повторно настроить это свойство, чтобы на новой странице использовалась заданная кодировка.
Если кодировка не задана страницей HTML, свойством textEncodingFallback или свойством textEncodingOverride, в содержимом HTML используется кодировка ISO-8859-1.
При настройке для свойства textEncodingOverride значения null восстанавливается режим по умолчанию.
Реализация
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):voidСвязанные элементы API
useCache | свойство |
useCache:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Задает необходимость обращения к локальному кэшу перед тем, как запросы HTTP, отправленные этим объектом, начнут извлекать данные.
Значением по умолчанию является initialized from URLRequestDefaults.useCache.
Реализация
public function get useCache():Boolean public function set useCache(value:Boolean):voidСвязанные элементы API
userAgent | свойство |
userAgent:String| Версии среды выполнения: | AIR 1.0 |
Строка агента пользователя, которую необходимо использовать в любых последующих запросах содержимого из данного объекта HTMLLoader.
Для настройки строки агента пользователя задайте свойство userAgent объекта HTMLLoader перед вызовом метода load(). Свойство userAgent объекта URLRequest, переданного в метод load(), не используется.
Можно настроить строку агента пользователя по умолчанию, используемую всеми объектами HTMLLoader в программном домене, путем определения свойства URLRequestDefaults.userAgent. Если для свойства userAgent объекта HTMLLoader значение не настроено (или в качестве значения настроено null), строке агента пользователя назначается значение статического свойства URLRequestDefaults.userAgent.
Если значение не задано как для свойства userAgent объекта HTMLLoader, так и для свойства URLRequestDefaults.userAgent, в качестве строки агента пользователя используется значение по умолчанию. Это значение по умолчанию зависит от конечной операционной системы (Mac OS, Linux или Windows), языка и версии, как указано в следующих примерах:
Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5
Реализация
public function get userAgent():String public function set userAgent(value:String):voidСвязанные элементы API
width | свойство |
width:Number[переопределить] | Версии среды выполнения: | AIR 1.0 |
Задает ширину прямоугольника холста HTML, подлежащего визуализации. Это ширина экранного объекта HTMLLoader в пикселях. Максимальное значение свойства width составляет 4 095 пикселов. При изменении этого свойства в объекте HTMLLoader выполняется повторная визуализация документа HTML. Диспетчеризация событий htmlBoundsChange может выполняться при изменении этого свойства. При настройке свойств width и height объекта HTMLLoader границы объекта изменяются, но содержимое не масштабируется (так же происходит с другими типами экранных объектов).
Реализация
override public function get width():Number override public function set width(value:Number):void window | свойство |
HTMLLoader | () | Конструктор |
public function HTMLLoader()| Версии среды выполнения: | AIR 1.0 |
Создает объект HTMLLoader.
cancelLoad | () | метод |
public function cancelLoad():void| Версии среды выполнения: | AIR 1.0 |
Отменяет любую выполняющуюся операцию загрузки.
createRootWindow | () | метод |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| Версии среды выполнения: | AIR 1.0 |
Создает новый объект NativeWindow, который содержит объект HTMLLoader. Используйте объект HTMLLoader, возвращенный эти методом, для загрузки содержимого HTML.
По умолчанию (если при вызове этого метода параметры не передаются) в новом окне используется стандартный системный Chrome и добавляются полосы прокрутки содержимого. Можно настроить параметры для изменения свойств нового окна.
По мере того как окно загружает содержимое и применяет таблицы стилей, могут возникать незначительные графические искажения. Чтобы предотвратить их отображение, задайте свойству visible значение false. После завершения загрузки и размещения содержимого в окне, его можно сделать видимым, изменив значение свойства window.nativeWindow.visible на true или вызвав метод window.nativeWindow.activate().
Параметры
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null, используются значения NativeWindowInitOptions по умолчанию.
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null, устанавливает границы окна. Если для любого свойства x, y, width или height задано значение NaN, для соответствующего измерения окна сохраняется значение по умолчанию.
|
flash.html:HTMLLoader — Новый объект HTMLLoader на этапе создания объекта NativeWindow.
|
getHistoryAt | () | метод |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| Версии среды выполнения: | AIR 1.0 |
Возвращает запись журнала в заданном положении.
Параметры
position:uint — Позиция в журнале.
|
flash.html:HTMLHistoryItem — Объект URLRequest для записи журнала в заданном положении.
|
Связанные элементы API
historyBack | () | метод |
public function historyBack():void| Версии среды выполнения: | AIR 1.0 |
По возможности выполняет обратный переход в журнале браузера.
Вызов этого метода объекта HTMLLoader аналогичен вызову метода back() свойства window.history в сценарии JavaScript на странице HTML.
Эта функция не приводит к возникновению ошибок.
Связанные элементы API
historyForward | () | метод |
public function historyForward():void| Версии среды выполнения: | AIR 1.0 |
По возможности выполняет переход вперед в журнале браузера.
Вызов этого метода объекта HTMLLoader аналогичен вызову метода forward() свойства window.history в сценарии JavaScript на странице HTML.
Эта функция не приводит к возникновению ошибок.
Связанные элементы API
historyGo | () | метод |
public function historyGo(steps:int):void| Версии среды выполнения: | AIR 1.0 |
Выполняет переход на заданное число шагов в журнале браузера. Если число положительное, выполняется переход вперед, если отрицательное — назад. Если для перехода указано нулевое число шагов, выполняется перезагрузка.
Вызов этого метода эквивалентен вызову метода go() свойства window.history в сценарии JavaScript на странице HTML.
Эта функция не приводит к возникновению ошибок.
Параметры
steps:int — Число шагов в журнале, на которое необходимо выполнить переход вперед (положительное число) или назад (отрицательное число).
|
Связанные элементы API
load | () | метод |
public function load(urlRequestToLoad:URLRequest):void| Версии среды выполнения: | AIR 1.0 |
Загружает объект HTMLLoader с данными с узла, заданного параметром urlRequestToLoad. При вызове этого метода для свойства loaded изначально настраивается значение false. Этот метод инициирует операцию, которая всегда выполняется асинхронно.
Вызов этого метода неявно отменяет любую предыдущую ожидающую операцию загрузки, инициированную этим методом или методом loadString(). Событие complete для предыдущей операции загрузки не будет доставлено.
Возможно, что событие complete не будет доставлено. Это происходит, когда не удается полностью загрузить содержимое HTML в объект HTMLLoader. Причиной может быть то, что содержимое HTML ссылается на URL-адрес сценария CGI, постоянно создающий новое содержимое.
Параметры
urlRequestToLoad:URLRequest — Объект URLRequest, в котором содержатся данные о загружаемом указателе URL. Кроме загружаемого указателя URL, в объекте URLRequest содержатся свойства, которые определяют метод отправки формы HTTP (GET или POST), любые данные, которые будут переданы в запросе, и заголовки запросов.
|
Связанные элементы API
loadString | () | метод |
public function loadString(htmlContent:String):void| Версии среды выполнения: | AIR 1.0 |
Загружает объект HTMLLoader с содержимым HTML в строке HTML. По завершении визуализации содержимого HTML в строке выполняется диспетчеризация события complete. Диспетчеризация события complete всегда выполняется асинхронно.
Вызов этого метода неявно отменяет любую предыдущую ожидающую операцию загрузки, инициированную этим методом или методом load(). Событие complete для предыдущей операции загрузки не будет доставлено.
Если в содержимом HTML, указанном в строке, отсутствует ссылка на внешние ресурсы, этот метод выполняет синхронную визуализацию содержимого HTML. Однако диспетчеризация события complete выполняется асинхронно. Если свойству loaded этого класса сразу после вызова этой функции задано значение true, это означает, что содержимое HTML, указанное в аргументе htmlContent, было визуализировано синхронно.
Возможно, что событие complete не будет доставлено. Это происходит, когда не удается полностью загрузить содержимое HTML в объект HTMLLoader. Причиной может быть то, что содержимое HTML ссылается на URL-адрес сценария CGI, постоянно создающий новое содержимое.
Содержимое, загруженное с помощью метода loadString(), помещается в изолированную программную среду безопасности приложения, только если свойство placeLoadStringContentInApplicationSandbox имеет значение true.
Параметры
htmlContent:String — Строка с содержимым HTML, которую необходимо загрузить в объект HTMLLoader.
|
Связанные элементы API
reload | () | метод |
public function reload():void| Версии среды выполнения: | AIR 1.0 |
Повторно загружает страницу из текущего положения.
complete | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.COMPLETE| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что последняя операция загрузки, запрошенная методом loadString или load, завершена. Диспетчеризация события выполняется после запуска события load кода JavaScript в модели HTML DOM объекта HTMLLoader. Передача события всегда выполняется асинхронно. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Event.COMPLETE определяет значение свойства type объекта complete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, который завершил загрузку. |
Связанные элементы API
htmlBoundsChange | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что одно или оба свойства contentWidth и contentHeight объекта HTMLLoader изменены. Причиной может быть, к примеру, загрузка нового изображения или другого содержимого. Обработчики событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Объект HTMLLoader может выполнить диспетчеризацию этого события в любое время после инициирования операции загрузки, даже после выполнения объектом диспетчеризации события complete.
Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта события htmlBoundsChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект HTMLLoader. |
target | Объект HTMLLoader. |
Связанные элементы API
htmlDOMInitialize | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что при выполнении операции загрузки создана модель HTML DOM. Методы load() и loadString() объекта HTMLLoader вызывают исключение во время отправки этого события. Любое свойство или метод любого объекта JavaScript, доступного в свойстве window объекта HTMLLoader, который управляет URL-адресом, загружаемым в объект HTMLLoader, вызывает исключение при отправке этого события. Например, настройка window.location путем задания свойства window объекта HTMLLoader вызывает исключение JavaScript.
Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект HTMLLoader. |
target | Объект HTMLLoader. |
Связанные элементы API
htmlRender | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.HTML_RENDER| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что визуализация содержимого объекта HTMLLoader полностью обновлена. Диспетчеризация этого события может выполняться довольно часто при любом изменении визуализации содержимого HTML. Например, диспетчеризация этого события выполняется при отображении нового содержимого после перехода по ссылке или визуализации содержимого HTML с помощью кода JavaScript. Слушатели событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Обработчикам этого события следует проверить свойства contentWidth и contentHeight объекта HTMLLoader для обновления всех полос прокрутки, связанных с эти объектом.
Объект HTMLLoader может выполнить диспетчеризацию этого события в любое время после инициирования операции загрузки, даже после выполнения объектом диспетчеризации события complete.
Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект HTMLLoader. |
target | Объект HTMLLoader. |
locationChange | Событие |
flash.events.LocationChangeEventсвойство LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| Версии среды выполнения: | AIR 2.7 |
Сигнализирует, что свойство location объекта HTMLLoader изменено. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Событие locationChange типа LocationChangeEvent отправляется объектом HTMLLoader в приложениях, использующих пространство имен AIR 2.7 и более поздних версий. В более ранних версиях AIR отправляемый объект события является экземпляром класса Event.
Связанные элементы API
locationChange | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.LOCATION_CHANGE| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что свойство location объекта HTMLLoader изменено. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Событие locationChange типа Event отправляется объектом HTMLLoader в приложениях, использующих версию пространства имен AIR, предшествующую 2.7. В AIR 2.7 и более поздних версий объект события является экземпляром LocationChangeEvent, который обеспечивает дополнительное свойство location, значением которого является URL-адрес новой страницы.
Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект HTMLLoader. |
target | Объект HTMLLoader. |
Связанные элементы API
locationChanging | Событие |
flash.events.LocationChangeEventсвойство LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.7 |
Сигнализирует, что свойство location объекта HTMLLoader готово к изменению.
Событие locationChanging отправляется, только когда изменение положения инициируется пользователем (например, щелчком по ссылке) или кодом, выполняемым внутри HTMLLoader (например, путем клиентской переадресации). По умолчанию новое расположение выводится на экран в этом объекте HTMLLoader. Можно вызвать метод preventDefault() объекта события для отмены поведения по умолчанию. Например, можно использовать функцию flash.net.navigateToURL() для открытия страницы в системном браузере на основе свойства location объекта события.
Событие locationChanging() не отправляется при вызове следующих методов:
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
Кроме того, это событие не отправляется, когда свойство navigateInSystemBrowser имеет значение true и целевая страница открыта в системном браузере, так как размещение HTMLLoader не изменяется.
LOCATION_CHANGING определяет значение объекта LocationChangeEvent свойства текста, отправляемого перед изменением положения страницы.
Пример ( Использование этого примера )
package{
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class LocationChanging extends Sprite
{
var htmlLoader:HTMLLoader = new HTMLLoader();
public function LocationChanging()
{
htmlLoader.width = stage.stageWidth;
htmlLoader.height = stage.stageHeight;
htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
this.addChild( htmlLoader );
}
private function onLocationChanging( event:LocationChangeEvent ):void
{
trace( "Location changing: " + event.location );
if ( event.location.indexOf( "http://www.adobe.com" ) < 0 )
{
event.preventDefault();
}
}
}
}
scroll | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.SCROLL| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что свойство scrollH или scrollV изменено объектом HTMLLoader. Объект HTMLLoader выполняет диспетчеризацию этого события, если JavaScript, выполняющийся в объекте HTMLLoader, вызывает метод scrollTo() объекта window и необходимое положение уже невидимо. Диспетчеризация события не выполняется, если код ActionScript изменяет свойство scrollH или scrollV. Обработчики событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Обработчикам этого события следует проверить свойства scrollH и scrollV для обновления всех полос прокрутки, связанных с объектом HTMLLoader.
Объект HTMLLoader может выполнить диспетчеризацию этого события в любое время после инициирования операции загрузки, даже после выполнения объектом диспетчеризации события complete.
Event.SCROLL определяет значение свойства type объекта события scroll.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Прокручиваемый объект TextField. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
uncaughtScriptException | Событие |
flash.events.HTMLUncaughtScriptExceptionEventсвойство HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что в объекте HTMLLoader создано необрабатываемое исключение JavaScript. Обработчики событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader. Событие можно отменить, и операцией по умолчанию при запуске в компоненте AIR Debug Launcher является отправка стека JavaScript для вывода трассировки.
КонстантаHTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION определяет значение свойства type для объекта события uncaughtScriptException.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
exceptionValue | Результат оценки выражения в инструкции throw, полученной в результате неперехваченного исключения. |
stackTrace | Массив объектов, представляющих трассировку стека во время выполнения инструкции throw, полученной в результате неперехваченного исключения. |
target | Объект HTMLLoader. |
Связанные элементы API
package {
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class HTMLLoaderExample extends Sprite
{
public function HTMLLoaderExample()
{
var html:HTMLLoader = new HTMLLoader();
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.width = stage.stageWidth;
html.height = stage.stageHeight;
html.load(urlReq);
addChild(html);
}
}
}
Tue Jun 12 2018, 11:34 AM Z