Пакет | flash.html |
Класс | public class HTMLLoader |
Наследование | HTMLLoader ![]() ![]() ![]() ![]() ![]() ![]() |
Версии среды выполнения: | AIR 1.0 |
Размером по умолчанию объекта HTMLLoader является 0 x 0 пикселов. Задайте свойства width
и height
, чтобы сделать объект HTMLLoader видимым.
Предельным значением для свойств width
и height
объекта HTMLLoader является 2880. При установке свойства width
или height
объекта HTMLLoader на значение, превышающее 2880, выдается исключение ArgumentError.
Свойство | Определено | ||
---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
![]() | alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
![]()
Задает обработку запросов аутентификации (true) или ее отсутствие (false) для запросов HTTP, отправленных этим объектом. | HTMLLoader | ||
![]() | blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
![]() | blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
![]() | buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
![]() | cacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
![]()
Задает необходимо кэширования данных успешных ответов для запросов HTTP, отправленных этим объектом. | HTMLLoader | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() [только для чтения]
Высота содержимого HTML (в пикселах). | HTMLLoader | ||
![]() [только для чтения]
Ширина содержимого HTML (в пикселах). | HTMLLoader | ||
![]() | contextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
![]() | doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | |
![]() | dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен. | Sprite | |
![]() | filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
![]() | focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
![]() | graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
![]() [только для чтения]
Определяет, является ли какое-либо содержимое в объекте HTMLLoader фокусируемым. | HTMLLoader | ||
![]()
Задает высоту прямоугольника холста HTML, подлежащего визуализации. | HTMLLoader | ||
![]() [только для чтения]
Полная длина списка журнала, включая предыдущие и последующие записи. | HTMLLoader | ||
![]()
Текущее положение в списке журнала. | HTMLLoader | ||
![]() | hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
![]()
Объект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title объекта HTMLLoader. | HTMLLoader | ||
![]() [только для чтения]
Обозначает, было ли доставлено событие загрузки JavaScript, соответствующее предыдущему вызову метода load() или loadString(), в HTML DOM в объекте HTMLLoader. | HTMLLoader | ||
![]() | loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
![]() [только для чтения]
Указатель URL для содержимого, загруженного в объект HTMLLoader. | HTMLLoader | ||
![]()
Задает необходимость управления стеком протоколов HTTP файлами cookie для данного объекта. | HTMLLoader | ||
![]() | mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
![]() | mouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши. | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши. | InteractiveObject | |
![]() | mouseX : Number [только для чтения]
Указывает координату x положения курсора мыши (в пикселах). | DisplayObject | |
![]() | mouseY : Number [только для чтения]
Указывает координату y положения курсора мыши (в пикселах). | DisplayObject | |
![]() | name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
![]()
Задает, необходимо ли при переходе в корневом фрейме содержимого HTML (например, при переходе по ссылке, если задано свойство window.location, или вызове метода window.open()) выполнять переход в объекте HTMLLoader (false) или системном веб-обозревателе по умолчанию (true). | HTMLLoader | ||
![]() | numChildren : int [только для чтения]
Возвращает число потомков данного объекта. | DisplayObjectContainer | |
![]() | opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
![]()
Задает белый непрозрачный (true) или прозрачный (false) фон документа HTMLLoader. | HTMLLoader | ||
![]() | parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
![]() [статические] [только для чтения]
Тип поддержки PDF в пользовательской системе, определенный как целочисленное кодовое значение. | HTMLLoader | ||
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
![]() | root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
![]() | rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
![]() | rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]() | rotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]() | rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
![]()
Программный домен, который необходимо использовать для объекта window.runtime в сценарии JavaScript на странице HTML. | HTMLLoader | ||
![]() | scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
![]() | scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
![]() | scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
![]() | scaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
![]()
Горизонтальное положение прокрутки содержимого HTML в объекте HTMLLoader. | HTMLLoader | ||
![]() | scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
![]()
Вертикальное положение прокрутки содержимого HTML в объекте HTMLLoader. | HTMLLoader | ||
![]() | soundTransform : SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
![]() | stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
![]() | tabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab. | DisplayObjectContainer | |
![]() | tabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab. | InteractiveObject | |
![]() | tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
![]()
Кодировка символов, используемая содержимым HTMLLoader, если кодировка символов не задана страницей HTML. | HTMLLoader | ||
![]()
Кодировка символов, используемая в содержимом HTMLLoader, перезаписывает любой параметр на странице HTML. | HTMLLoader | ||
![]() | textSnapshot : TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() | transform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
![]()
Задает необходимость обращения к локальному кэшу перед тем, как запросы HTTP, отправленные этим объектом, начнут извлекать данные. | HTMLLoader | ||
![]() | useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
![]()
Строка агента пользователя, которую необходимо использовать в любых последующих запросах содержимого из данного объекта HTMLLoader. | HTMLLoader | ||
![]() | visible : Boolean
Определяет видимость экранного объекта. | DisplayObject | |
![]()
Задает ширину прямоугольника холста HTML, подлежащего визуализации. | HTMLLoader | ||
![]() [только для чтения]
Глобальный объект 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() с заданной точкой. | DisplayObjectContainer | |
Отменяет любую выполняющуюся операцию загрузки. | HTMLLoader | ||
![]() |
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
![]() [статические]
Создает новый объект NativeWindow, который содержит объект HTMLLoader. | HTMLLoader | ||
![]() |
Передает событие в поток событий. | EventDispatcher | |
![]() | DisplayObject | ||
![]() |
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
![]() |
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | |
![]() |
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
![]() |
Возвращает позицию индекса для дочернего экземпляра DisplayObject. | DisplayObjectContainer | |
![]() | DisplayObject | ||
Возвращает запись журнала в заданном положении. | HTMLLoader | ||
![]() |
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур. | DisplayObject | |
![]() |
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные). | DisplayObject | |
![]() |
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа. | EventDispatcher | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
По возможности выполняет обратный переход в журнале обозревателя. | HTMLLoader | ||
По возможности выполняет переход вперед в журнале обозревателя. | HTMLLoader | ||
Выполняет переход на заданное число шагов в журнале обозревателя. | HTMLLoader | ||
![]() |
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним. | DisplayObject | |
![]() |
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Загружает объект HTMLLoader с данным с узла, заданного параметром urlRequestToLoad. | HTMLLoader | ||
Загружает объект HTMLLoader с содержимым HTML в строке HTML. | HTMLLoader | ||
![]() |
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
![]() | DisplayObject | ||
![]() | DisplayObject | ||
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Повторно загружает страницу из текущего положения. | HTMLLoader | ||
![]() |
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
![]() |
Изменяет положение существующего потомка в DisplayObjectContainer. | DisplayObjectContainer | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
![]() |
Завершает метод startDrag(). | Sprite | |
![]() |
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта. | DisplayObjectContainer | |
![]() |
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков. | DisplayObjectContainer | |
![]() |
Возвращает строковое представление заданного объекта. | Object | |
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
![]() |
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
![]() | Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
![]() | Отправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
![]() | Отправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста. | InteractiveObject | ||
![]() | Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
Сигнализирует, что последняя операция загрузки, запрошенная методом loadString или load, завершена. | HTMLLoader | |||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню. | InteractiveObject | ||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню. | InteractiveObject | ||
![]() | [многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным. | EventDispatcher | ||
![]() | Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | ||
![]() | [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
![]() | [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
![]() | Отправляется, когда экранный объект перемещается в фокус. | InteractiveObject | ||
![]() | Отправляется, когда экранный объект покидает фокус. | InteractiveObject | ||
![]() | [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
Сигнализирует, что одно или оба свойства contentWidth и contentHeight объекта HTMLLoader изменены. | HTMLLoader | |||
Сигнализирует, что при выполнении операции загрузки создана модель HTML DOM. | HTMLLoader | |||
Сигнализирует, что визуализация содержимого объекта HTMLLoader полностью обновлена. | HTMLLoader | |||
![]() | Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | ||
![]() | Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | ||
![]() | Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | ||
Сигнализирует, что свойство расположения объекта HTMLLoader изменено. | HTMLLoader | |||
![]() | Отправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | ||
![]() | Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | ||
![]() | Отправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject. | InteractiveObject | ||
![]() | Отправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player. | InteractiveObject | ||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню. | InteractiveObject | ||
![]() | Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
![]() | Отправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
![]() | [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
![]() | Отправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject. | InteractiveObject | ||
![]() | Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
Сигнализирует, что свойство scrollH или scrollV изменено объектом HTMLLoader. | HTMLLoader | |||
![]() | Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню. | InteractiveObject | ||
![]() | Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | ||
![]() | Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | ||
![]() | Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | ||
Сигнализирует, что в объекте HTMLLoader создано необрабатываемое исключение JavaScript. | HTMLLoader |
![]() | свойство |
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
См. также
![]() | свойство |
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
См. также
![]() | свойство |
contentHeight:Number
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Высота содержимого HTML (в пикселах). Это свойство можно изменить аналогичным изменению размеров объекта HTMLLoader способом. Например, на странице HTML часто используется полное значение высоты объекта HTMLLoader, и свойство contentHeight
может измениться при изменении высоты объекта HTMLLoader.
public function get contentHeight():Number
![]() | свойство |
contentWidth:Number
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Ширина содержимого HTML (в пикселах). Это свойство можно изменить аналогичным изменению размеров объекта HTMLLoader способом. Например, на странице HTML часто используется полное значение ширины объекта HTMLLoader, и свойство contentWidth
может измениться при изменении ширины объекта HTMLLoader.
public function get contentWidth():Number
![]() | свойство |
hasFocusableContent:Boolean
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Определяет, является ли какое-либо содержимое в объекте HTMLLoader фокусируемым.
public function get hasFocusableContent():Boolean
![]() | свойство |
height:Number
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Задает высоту прямоугольника холста HTML, подлежащего визуализации. Это высота экранного объекта HTMLLoader в пикселах. При изменении этого свойства в объекте HTMLLoader выполняется повторная визуализация документа HTML. Диспетчеризация событий htmlBoundsChanged
может выполняться при изменении этого свойства. При настройке свойства width
или height
объекта HTMLLoader границы объекта изменяются, но содержимое не масштабируется (так же происходит с другими типами экранных объектов).
public function get height():Number
public function set height(value:Number):void
![]() | свойство |
historyLength:uint
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Полная длина списка журнала, включая предыдущие и последующие записи. Для этого свойства установлено такое же значение, что и для свойства JavaScript window.history.length
страницы HTML.
public function get historyLength():uint
См. также
![]() | свойство |
historyPosition:uint
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Текущее положение в списке журнала. Список журнала соответствует объекту window.history
страницы HTML. Записи, расположенные перед текущим положением, называются предыдущим списком; записи после текущего положения называются последующим списком. При попытке настроить положение после конечных записей задается положение в конце списка.
public function get historyPosition():uint
public function set historyPosition(value:uint):void
См. также
![]() | свойство |
htmlHost:HTMLHost
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Объект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title
объекта HTMLLoader. Для переопределения поведения по умолчанию объекта HTMLLoader создайте подкласс класса HTMLHost и переопределите функции его членов для обработки различных изменений пользовательского интерфейса в содержимом HTML.
public function get htmlHost():HTMLHost
public function set htmlHost(value:HTMLHost):void
См. также
![]() | свойство |
loaded:Boolean
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Обозначает, было ли доставлено событие загрузки JavaScript, соответствующее предыдущему вызову метода load()
или loadString()
, в HTML DOM в объекте HTMLLoader. Для этого свойства задано значение true
перед диспетчеризацией события complete
. Настройка для этого свойства значения true
может быть невозможна. Причины аналогичны тем, по которым выполнение диспетчеризации события complete
невозможно.
public function get loaded():Boolean
![]() | свойство |
location:String
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Указатель URL для содержимого, загруженного в объект HTMLLoader.
public function get location():String
![]() | свойство |
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
См. также
![]() | свойство |
navigateInSystemBrowser:Boolean
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Задает, необходимо ли при переходе в корневом фрейме содержимого HTML (например, при переходе по ссылке, если задано свойство window.location
, или вызове метода window.open()
) выполнять переход в объекте HTMLLoader (false
) или системном веб-обозревателе по умолчанию (true
). Настройте для этого свойства значение true
, если необходимо, чтобы все переходы выполнялись в системном веб-обозревателе (а не в объекте HTMLLoader).
Значение по умолчанию false
public function get navigateInSystemBrowser():Boolean
public function set navigateInSystemBrowser(value:Boolean):void
![]() | свойство |
paintsDefaultBackground:Boolean
[чтение и запись] Версии среды выполнения: | 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: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
См. также
![]() | свойство |
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 находится в защищенном домене, отличном от домена вызывающего метода.
|
См. также
![]() | свойство |
scrollH:Number
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Горизонтальное положение прокрутки содержимого HTML в объекте HTMLLoader.
public function get scrollH():Number
public function set scrollH(value:Number):void
![]() | свойство |
scrollV:Number
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Вертикальное положение прокрутки содержимого HTML в объекте HTMLLoader.
public function get scrollV():Number
public function set scrollV(value:Number):void
![]() | свойство |
textEncodingFallback:String
[чтение и запись] Версии среды выполнения: | 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
См. также
![]() | свойство |
textEncodingOverride:String
[чтение и запись] Версии среды выполнения: | 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
См. также
![]() | свойство |
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
См. также
![]() | свойство |
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 или Windows), языка и версии, как указано в двух следующих примерах:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, например Gecko) AdobeAIR/1.0"
"Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, например Gecko) AdobeAIR/1.0"
public function get userAgent():String
public function set userAgent(value:String):void
См. также
![]() | свойство |
width:Number
[чтение и запись] Версии среды выполнения: | AIR 1.0 |
Задает ширину прямоугольника холста HTML, подлежащего визуализации. Это ширина экранного объекта HTMLLoader в пикселах. При изменении этого свойства в объекте HTMLLoader выполняется повторная визуализация документа HTML. Диспетчеризация событий htmlBoundsChange
может выполняться при изменении этого свойства. При настройке свойств width
и height
объекта HTMLLoader границы объекта изменяются, но содержимое не масштабируется (так же происходит с другими типами экранных объектов).
public function get width():Number
public function set width(value:Number):void
![]() | свойство |
window:Object
[только для чтения] Версии среды выполнения: | AIR 1.0 |
Глобальный объект JavaScript для содержимого, загруженного в управляющий элемент HTML.
public function get window():Object
![]() | () | Конструктор |
public function HTMLLoader()
Версии среды выполнения: | AIR 1.0 |
Создает объект HTMLLoader.
![]() | () | метод |
public function cancelLoad():void
Версии среды выполнения: | AIR 1.0 |
Отменяет любую выполняющуюся операцию загрузки.
![]() | () | метод |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader
Версии среды выполнения: | AIR 1.0 |
Создает новый объект NativeWindow, который содержит объект HTMLLoader. Используйте объект HTMLLoader, возвращенный эти методом, для загрузки содержимого HTML.
По умолчанию (если при вызове этого метода параметры не передаются) в новом окне используется стандартные системные настройки цвета и добавляются полосы прокрутки содержимого. Можно настроить параметры для изменения свойств нового окна.
Параметры
visible:Boolean (default = true ) — Указывает, является ли окно видимым.
| |
windowInitOptions:NativeWindowInitOptions (default = null ) — Задает параметры инициализации окна; если задано значение null , используются значения NativeWindowInitOptions по умолчанию.
| |
scrollBarsVisible:Boolean (default = true ) — Задает, будут ли в окне доступны полосы прокрутки.
| |
bounds:Rectangle (default = null ) — Если задано значение null , устанавливает границы окна. Если для любого свойства x , y , width или height задано значение NaN , для соответствующего размера окна сохраняется значение по умолчанию.
|
HTMLLoader — Новый объект HTMLLoader на этапе создания объекта NativeWindow.
|
![]() | () | метод |
public function getHistoryAt(position:uint):HTMLHistoryItem
Версии среды выполнения: | AIR 1.0 |
Возвращает запись журнала в заданном положении.
Параметры
position:uint — Положение в списке журнала.
|
HTMLHistoryItem — Объект URLRequest для записи журнала в заданном положении.
|
См. также
![]() | () | метод |
public function historyBack():void
Версии среды выполнения: | AIR 1.0 |
По возможности выполняет обратный переход в журнале обозревателя.
Вызов этого метода объекта HTMLLoader аналогичен вызову метода back()
свойства window.history
в сценарии JavaScript на странице HTML.
Эта функция не порождает ошибок.
См. также
![]() | () | метод |
public function historyForward():void
Версии среды выполнения: | AIR 1.0 |
По возможности выполняет переход вперед в журнале обозревателя.
Вызов этого метода объекта HTMLLoader аналогичен вызову метода forward()
свойства window.history
в сценарии JavaScript на странице HTML.
Эта функция не порождает ошибок.
См. также
![]() | () | метод |
public function historyGo(steps:int):void
Версии среды выполнения: | AIR 1.0 |
Выполняет переход на заданное число шагов в журнале обозревателя. Если число положительное, выполняется переход вперед, если отрицательное — назад. Если для перехода указано нулевое число шагов, выполняется перезагрузка.
Вызов этого метода эквивалентен вызову метода go()
свойства window.history
в сценарии JavaScript на странице HTML.
Эта функция не порождает ошибок.
Параметры
steps:int — Число шагов в списке журнала, на которое необходимо выполнить переход вперед (положительное число) или назад (отрицательное число).
|
См. также
![]() | () | метод |
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), любые данные, которые будут переданы в запросе, и заголовки запросов.
|
См. также
![]() | () | метод |
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()
, помещается в "песочницу" безопасности приложения.
Параметры
htmlContent:String — Строка с содержимым HTML, которую необходимо загрузить в объект HTMLLoader.
|
![]() | () | метод |
public function reload():void
Версии среды выполнения: | AIR 1.0 |
Повторно загружает страницу из текущего положения.
![]() | Событие |
flash.events.Event
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 | Сетевой объект, который завершил загрузку. |
См. также
![]() | Событие |
flash.events.Event
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. |
См. также
![]() | Событие |
flash.events.Event
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. |
См. также
![]() | Событие |
flash.events.Event
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. |
![]() | Событие |
flash.events.Event
flash.events.Event.LOCATION_CHANGE
Версии среды выполнения: | AIR 1.0 |
Сигнализирует, что свойство location
объекта HTMLLoader изменено. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.
Event.LOCATION_CHANGE
определяет значение свойства type
объекта события locationChange
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект HTMLLoader. |
target | Объект HTMLLoader. |
См. также
![]() | Событие |
flash.events.Event
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 , чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент. |
![]() | Событие |
flash.events.HTMLUncaughtScriptExceptionEvent
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. |
См. также