Свойства отображения объектов HTMLLoader

Основные свойства отображения HTMLLoader позволяют расположить элемент управления внутри родительского экранного объекта, установить размер, отобразить или скрыть элемент управления. Не следует изменять эти свойства для объекта HTMLLoader окна HTML.

В число основных свойств входят следующие:

За пределами окна HTML свойства width и height объекта HTMLLoader по умолчанию установлены на 0. Ширину и высоту необходимо задать до того, как будет видимо содержимое HTML. Содержимое HTML подгоняется под размер HTMLLoader в соответствии со свойствами HTML и CSS содержимого. При изменении размера HTMLLoader содержимое загружается повторно.

При загрузке содержимого в новый объект HTMLLoader (со свойством width, установленным на 0) возникает соблазн задать свойства width и height объекта HTMLLoader при помощи свойств contentWidth и contentHeight. Такой метод работает для страниц с достаточной минимальной шириной, если они развернуты в соответствии с правилами HTML и спецификации CSS. Однако некоторые страницы имеют длинный и узкий макет из-за отсутствия достаточной ширины, обеспечиваемой объектом HTMLLoader.

Свойство paintsDefaultBackground объекта HTMLLoader, которое по умолчанию имеет значение true, задает непрозрачный фон объекта HTMLLoader. Если свойство paintsDefaultBackground имеет значение false, фон прозрачный. Контейнер объектов отображения или другие экранные объекты, расположенные под объектом HTMLLoader, видимы за элементами основного фона содержимого HTML.

Если для элемента основной части документа HTML или другого его элемента задан фоновый цвет (с использованием style="background-color:gray", например), то фон этой части документа HTML непрозрачный и отображается с заданным фоновым цветом. Если задать свойство opaqueBackground объекта HTMLLoader при свойстве paintsDefaultBackground установленным на false, то цвет, заданный для свойства opaqueBackground, становится видимым.

Избегайте изменения масштаба объекта HTMLLoader выше коэффициента 1.0. Текст содержимого HTMLLoader отображается при определенном разрешении и при увеличении масштаба объекта HTMLLoader выглядит пикселизированным. Во избежание масштабирования объекта HTMLLoader, а также его содержимого, при изменении размера окна установите свойство scaleMode объекта Stage на значение StageScaleMode.NO_SCALE.

Содержимое SWF и PDF, загруженное в объект HTMLLoader, исчезает при следующих условиях:

• При масштабировании объекта HTMLLoader выше или ниже коэффициента 1.0.

• При установке свойства alpha объекта HTMLLoader на значение, отличное от 1.0.

• При вращении содержимого HTMLLoader.

Содержимое снова отобразится при удалении проблемного значения свойства и активных фильтров.

К тому же, среда выполнения не может отображать содержимое PDF в прозрачных окнах. Среда выполнения отображает содержимое SWF, внедренное в страницу HTML, только когда параметр wmode объекта или тега внедрения принимает значение opaque или transparent. Так как для wmode по умолчанию используется значение window, то содержимое SWF не отображается в прозрачных окнах до принудительного изменения значения параметра wmode.

Дополнительную информацию о загрузке подобного материала в HTMLLoader см. в разделах Вложение SWF-содержимого в HTML и Добавление PDF-содержимого в приложения AIR.

Класс HTMLLoader наследует несколько методов, которые можно использовать для специальных эффектов. В общем, использование этих эффектов для отображения HTMLLoader имеет некоторые ограничения, но они полезны для создания переходов и других временных эффектов. Например, при отображении диалогового окна для ввода данных пользователем можно применить размытие к отображению основного окна, пока пользователь не закроет диалоговое окно. Подобным образом можно применить к отображению затухание при закрытии окна.

В число дополнительных свойств входят следующие:

Следующий пример иллюстрирует установку массива filters для размытия всего отображения HTML:

var html:HTMLLoader = new HTMLLoader(); 
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/"); 
html.load(urlReq); 
html.width = 800; 
html.height = 600; 
 
var blur:BlurFilter = new BlurFilter(8); 
var filters:Array = [blur]; 
html.filters = filters;