flash.htmlHTMLSWFCapability Класс HTMLSWFCapability содержит возможные значения свойства swfCapability объекта HTMLLoader.Object Класс HTMLSWFCapability содержит возможные значения свойства swfCapability объекта HTMLLoader. Он также определяет значения свойства errorID объекта ErrorEvent, диспетчеризация которого выполнена, если попытка загрузки содержимого SWF была неудачной. ERROR_INSTALLED_PLAYER_NOT_FOUND Не обнаружено ни одной версии Adobe Flash Player.3221int Не обнаружено ни одной версии Adobe Flash Player. Объекту HTMLLoader не удается отобразить содержимое PDF. ERROR_INSTALLED_PLAYER_TOO_OLD Приложение Adobe Flash Player обнаружено, но его версия устарела.3222int Приложение Adobe Flash Player обнаружено, но его версия устарела. Объекту HTMLLoader не удается отобразить содержимое SWF. STATUS_OK Обнаружена допустимая версия Adobe Flash Player, и содержимое SWF может быть загружено в объект HTMLLoader.0int Обнаружена допустимая версия Adobe Flash Player, и содержимое SWF может быть загружено в объект HTMLLoader. HTMLHistoryItem Объект HTMLHistoryItem описывает расположение в журнале навигации объекта HTMLLoader.Object Объект HTMLHistoryItem описывает расположение в журнале навигации объекта HTMLLoader. isPost Обозначает, включает ли страница HTML данные POST.Boolean Обозначает, включает ли страница HTML данные POST. originalUrl Исходный указатель URL страницы HTML (перед выполнением любых перенаправлений).String Исходный указатель URL страницы HTML (перед выполнением любых перенаправлений). title Заголовок страницы HTML.String Заголовок страницы HTML. url URL-адрес страницы HTML.String URL-адрес страницы HTML. HTMLHost Объект HTMLHost определяет поведение объекта HTMLLoader для элементов пользовательского интерфейса, которыми можно управлять путем задания различных свойств или вызова методов объекта window страницы HTML.Object Объект HTMLHost определяет поведение объекта HTMLLoader для элементов пользовательского интерфейса, которыми можно управлять путем задания различных свойств или вызова методов объекта window страницы HTML. Учитываются следующие методы и свойства:

window.blur()
window.focus()
window.moveBy()
window.moveTo()
window.location
window.close()
window.open()
window.resizeBy()
window.resizeTo()
window.status
window.document.title

Методы в классе HTMLHost предоставляют способы обработки изменений в каждом из этих параметров window. Для использования этого класса необходимо создать новый класс (подкласс), расширяющий класс HTMLHost и перезаписывающий методы, для которых необходимо определить поведение. Методы класса HTMLHost обрабатывают следующие свойства и методы JavaScript:

Свойство или метод JavaScriptМетод HTMLHostwindow.blur()windowBlur()window.focus()windowFocuswindow.locationupdateLocationwindow.close()windowClosewindow.open()createWindowwindow.statusupdateStatuswindow.document.titleupdateTitle

При изменении методов window.moveBy(), window.moveTo(), window.resizeBy() и window.resizeTo() перезаписывается метод set windowRect() в подклассе HTMLHost.

Каждый объект HTMLHost можно связать только с одним объектом HTMLLoader. Эта взаимосвязь устанавливается путем назначения экземпляра HTMLHost свойству htmlHost объекта HTMLLoader. При присвоении значения null свойству htmlHost объекта HTMLLoader или объекта HTMLHost в качестве свойства htmlHost другого объекта HTMLLoader выполняется удаление HTMLHost из первого объекта HTMLLoader.

Следующий код определяет CustomHost, подкласс класса HTMLHost. Методы класса CustomHost переопределяют наследованные методы класса HTMLHost при определении действий, предпринимаемых, когда код JavaScript страницы HTMLLoader задает различные свойства или вызывает различные методы объекта window: package { import flash.html.HTMLHost; import flash.html.HTMLLoader; import flash.display.NativeWindow; import flash.display.NativeWindowInitOptions; import flash.display.StageScaleMode; import flash.geom.Rectangle; import flash.text.TextField; public class CustomHost extends HTMLHost { import flash.html.*; public var statusField:TextField; public function CustomHost(defaultBehaviors:Boolean=true) { super(defaultBehaviors); } override public function windowClose():void { htmlLoader.stage.window.close(); } override public function createWindow(windowCreateOptions:HTMLWindowCreateOptions):HTMLLoader { var initOptions:NativeWindowInitOptions = new NativeWindowInitOptions(); var window:NativeWindow = new NativeWindow(initOptions); window.visible = true; var htmlLoader2:HTMLLoader = new HTMLLoader(); htmlLoader2.width = window.width; htmlLoader2.height = window.height; window.stage.scaleMode = StageScaleMode.NO_SCALE; window.stage.addChild(htmlLoader2); return htmlLoader2; } override public function updateLocation(locationURL:String):void { trace(locationURL); } override public function set windowRect(value:Rectangle):void { htmlLoader.stage.nativeWindow.bounds = value; } override public function updateStatus(status:String):void { statusField.text = status; } override public function updateTitle(title:String):void { htmlLoader.stage.nativeWindow.title = title + "- Example Application"; } override public function windowBlur():void { htmlLoader.alpha = 0.5; } override public function windowFocus():void { htmlLoader.alpha = 1; } } } Создайте следующий класс, который добавляет объект HTMLLoader в рабочую область, а также объект TextField с именем statusBar. Объект HTMLLoader определяет объект CustomHost в качестве своего свойства htmlHost: package { import flash.display.Sprite; public class SimpleHTMLBox extends Sprite { import flash.html.HTMLHost; import flash.html.HTMLLoader; import flash.text.TextField; import flash.net.URLRequest; import CustomHost; private var host:CustomHost; private var statusField:TextField; private var html:HTMLLoader; public function SimpleHTMLBox() { html = new HTMLLoader(); var url:String = "Test.html"; var urlReq:URLRequest = new URLRequest(url); html.load(urlReq); host = new CustomHost(); html.htmlHost = host; statusField = new TextField(); host.statusField = statusField; configureUI(); } private function configureUI():void { html.width = 400; html.height = 200; statusField.width = 400; statusField.height = 24; statusField.border = true; statusField.y = 200; addChild(html); addChild(statusField); } } }

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

Создайте страницу HTML с именем Test.html в каталоге ресурсов приложения (каталог, содержащий файл дескриптора приложения) и вставьте в нее следующее содержимое:

<html> <head> <title>Test</title> </head> <body> <a href="#" onclick="window.open('Test.html')">window.open('Test.html')</a> <a href="#" onclick="window.document.location = 'www.adobe.com'">window.document.location = 'www.adobe.com'</a> <a href="#" onclick="window.moveBy(6, 12)">moveBy(6, 12)</a> <a href="#" onclick="window.close()">window.close()</a> <a href="#" onclick="window.blur()">window.blur()</a> <a href="#" onclick="window.focus()">window.focus()</a> <a href="#" onclick="window.status = new Date().toString()">window.status = new Date().toString()</a> </body> </html>

При тестировании приложения класс CustomHost обрабатывает связанные с пользовательским интерфейсом настройки JavaScript страницы HTML.

HTMLHost Создает объект HTMLHost.defaultBehaviorsBooleantrueОпределяет необходимость предоставления вариантов поведения корневого содержимого по умолчанию. Создает объект HTMLHost. createWindow Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.open().Объект HTMLLoader, содержащий новую страницу HTML. Обычно новый объект HTMLLoader создается в этом методе, добавляется при создании нового объекта NativeWindow, а затем возвращается. flash.html:HTMLLoaderwindowCreateOptionsflash.html:HTMLWindowCreateOptionsОбъект, содержащий свойства в строке, переданной в качестве параметра features при вызове метода window.open(). Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.open().

По умолчанию во время выполнения при вызове в сценарии JavaScript метода window.open() на странице HTML объекта HTMLLoader новый объект NativeWindow не открывается. Новый объект NativeWindow можно открыть во время выполнения путем создания нового объекта NativeWindow в перезаписи метода createWindow в подклассе класса HTMLHost.

updateLocation Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader задает свойство window.location.locationURLStringЗначение, которое настроено для свойства location свойства window объекта HTMLLoader. Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader задает свойство window.location. updateStatus Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader задает свойство window.status.statusStringЗначение, которое настроено для свойства status свойства window объекта HTMLLoader. Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader задает свойство window.status. updateTitle Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader задает свойство window.document.title или изменяется элемент title с помощью элемента DOM или при загрузке новой страницы.titleStringЗначение, которое настроено для свойства window.document.title объекта HTMLLoader. Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader задает свойство window.document.title или изменяется элемент title с помощью элемента DOM или при загрузке новой страницы. windowBlur Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.blur(). Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.blur(). windowClose Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.close(). Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.close().

По умолчанию при вызове в сценарии JavaScript метода window.close() на странице HTML объекта HTMLLoader закрываются окна, в которых содержится объект HTMLLoader.

windowFocus Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.focus(). Обращение к функции происходит, когда код JavaScript в объекте HTMLLoader вызывает метод window.focus(). htmlLoader Объект HTMLLoader, к которому применяется данный объект HostControl.flash.html:HTMLLoader Объект HTMLLoader, к которому применяется данный объект HostControl. Свойство htmlHost этого объекта HTMLLoader настроено для данного объекта HostControl. windowRect Свойство, изменяющееся, когда код JavaScript в объекте HTMLLoader вызывает метод window.moveBy(), window.moveTo(), window.resizeBy() или window.resizeTo().flash.geom:Rectangle Свойство, изменяющееся, когда код JavaScript в объекте HTMLLoader вызывает метод window.moveBy(), window.moveTo(), window.resizeBy() или window.resizeTo().

В подклассе HTMLHost при необходимости перезапишите метод set windowRect() для обработки новых границ окна.

HTMLPDFCapability Класс HTMLPDFCapability содержит возможные значения свойства pdfCapability объекта HTMLLoader.Object Класс HTMLPDFCapability содержит возможные значения свойства pdfCapability объекта HTMLLoader. Он также определяет значения свойства errorID объекта ErrorEvent, диспетчеризация которого выполнена, если попытка загрузки содержимого PDF была неудачной. ERROR_CANNOT_LOAD_READER Ошибка возвращена ОС при попытке загрузить приложение Adobe Reader или Acrobat или одну из необходимых библиотек.3204int Ошибка возвращена ОС при попытке загрузить приложение Adobe Reader или Acrobat или одну из необходимых библиотек.

Примечание. Ошибка не возвращается из объекта HTMLLoader.pdfCapability, она передается как свойство errorID объекта ErrorEvent, диспетчеризация которого выполняется, когда объект HTMLLoader пытается загрузить содержимое PDF, а операционная система возвращает ошибку. Объект HTMLLoader.pdfCapability может возвращать значение PDFCapability.STATUS_OK, поскольку он проверяет только конфигурацию и не пытается загружать библиотеки.

ERROR_INSTALLED_READER_NOT_FOUND Версия Adobe Reader не обнаружена.3201int Версия Adobe Reader не обнаружена. Объекту HTMLLoader не удается отобразить содержимое PDF. ERROR_INSTALLED_READER_TOO_OLD Приложение Adobe Reader обнаружено, но версия является слишком старой.3202int Приложение Adobe Reader обнаружено, но версия является слишком старой. Объекту HTMLLoader не удается отобразить содержимое PDF. ERROR_PREFERRED_READER_TOO_OLD Необходимая версия (8.1 или более поздняя) приложения Adobe Reader или Acrobat обнаружена, но версия приложения Adobe Reader, настроенная для обработки содержимого PDF, является более ранней, чем 8.1.3203int Необходимая версия (8.1 или более поздняя) приложения Adobe Reader или Acrobat обнаружена, но версия приложения Adobe Reader, настроенная для обработки содержимого PDF, является более ранней, чем 8.1. Объекту HTMLLoader не удается отобразить содержимое PDF. HTMLLoader Класс HTMLLoader определяет тип экранного объекта, который является контейнером содержимого HTML.flash.display:Sprite Класс HTMLLoader определяет тип экранного объекта, который является контейнером содержимого HTML.

Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах, но не поддерживается на мобильных устройствах или в средах AIR для телевизионных устройств. Используйте свойство HTMLLoader.isSupported, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».

Размером по умолчанию объекта 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.

Следующий код создает объект HTMLLoader, задает его ширину и высоту, загружает URL-адрес http://www.adobe.com и добавляет объект в список отображения: 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); } } } htmlDOMInitialize Сигнализирует, что при выполнении операции загрузки создана модель HTML DOM.flash.events.Event.HTML_DOM_INITIALIZEflash.events.Event Сигнализирует, что при выполнении операции загрузки создана модель HTML DOM. Методы load() и loadString() объекта HTMLLoader вызывают исключение во время отправки этого события. Любое свойство или метод любого объекта JavaScript, доступного в свойстве window объекта HTMLLoader, который управляет URL-адресом, загружаемым в объект HTMLLoader, вызывает исключение при отправке этого события. Например, настройка window.location путем задания свойства window объекта HTMLLoader вызывает исключение JavaScript. uncaughtScriptException Сигнализирует, что в объекте HTMLLoader создано необрабатываемое исключение JavaScript.flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTIONflash.events.HTMLUncaughtScriptExceptionEvent Сигнализирует, что в объекте HTMLLoader создано необрабатываемое исключение JavaScript. Обработчики событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader. Событие можно отменить, и операцией по умолчанию при запуске в компоненте AIR Debug Launcher является отправка стека JavaScript для вывода трассировки. scroll Сигнализирует, что свойство scrollH или scrollV изменено объектом HTMLLoader.flash.events.Event.SCROLLflash.events.Event Сигнализирует, что свойство scrollH или scrollV изменено объектом HTMLLoader. Объект HTMLLoader выполняет диспетчеризацию этого события, если JavaScript, выполняющийся в объекте HTMLLoader, вызывает метод scrollTo() объекта window и необходимое положение уже невидимо. Диспетчеризация события не выполняется, если код ActionScript изменяет свойство scrollH или scrollV. Обработчики событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.

Обработчикам этого события следует проверить свойства scrollH и scrollV для обновления всех полос прокрутки, связанных с объектом HTMLLoader.

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

htmlBoundsChange Сигнализирует, что одно или оба свойства contentWidth и contentHeight объекта HTMLLoader изменены.flash.events.Event.HTML_BOUNDS_CHANGEflash.events.Event Сигнализирует, что одно или оба свойства contentWidth и contentHeight объекта HTMLLoader изменены. Причиной может быть, к примеру, загрузка нового изображения или другого содержимого. Обработчики событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.

locationChange Сигнализирует, что свойство location объекта HTMLLoader изменено.flash.events.LocationChangeEvent.LOCATION_CHANGEflash.events.LocationChangeEventСигнализирует, что свойство location объекта HTMLLoader изменено. Сигнализирует, что свойство location объекта HTMLLoader изменено. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.

Событие locationChange типа LocationChangeEvent отправляется объектом HTMLLoader в приложениях, использующих пространство имен AIR 2.7 и более поздних версий. В более ранних версиях AIR отправляемый объект события является экземпляром класса Event.

locationChange Сигнализирует, что свойство location объекта HTMLLoader изменено.flash.events.Event.LOCATION_CHANGEflash.events.EventСигнализирует, что свойство location объекта HTMLLoader изменено. Сигнализирует, что свойство location объекта HTMLLoader изменено. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.

Событие locationChange типа Event отправляется объектом HTMLLoader в приложениях, использующих версию пространства имен AIR, предшествующую 2.7. В AIR 2.7 и более поздних версий объект события является экземпляром LocationChangeEvent, который обеспечивает дополнительное свойство location, значением которого является URL-адрес новой страницы.

locationChanging Сигнализирует, что свойство location объекта HTMLLoader готово к изменению.flash.events.LocationChangeEvent.LOCATION_CHANGINGflash.events.LocationChangeEventСигнализирует, что свойство location объекта HTMLLoader готово к изменению. Сигнализирует, что свойство location объекта HTMLLoader готово к изменению.

Событие locationChanging отправляется, только когда изменение положения инициируется пользователем (например, щелчком по ссылке) или кодом, выполняемым внутри HTMLLoader (например, путем клиентской переадресации). По умолчанию новое расположение выводится на экран в этом объекте HTMLLoader. Можно вызвать метод preventDefault() объекта события для отмены поведения по умолчанию. Например, можно использовать функцию flash.net.navigateToURL() для открытия страницы в системном браузере на основе свойства location объекта события.

Событие locationChanging() не отправляется при вызове следующих методов:

load()
loadString()
reload()
historyBack()
historyForward()
historyGo()

Кроме того, это событие не отправляется, когда свойство navigateInSystemBrowser имеет значение true и целевая страница открыта в системном браузере, так как размещение HTMLLoader не изменяется.

Следующий код создает объект HTMLLoader, задает его ширину и высоту, загружает URL-адрес http://www.adobe.com и добавляет объект в список отображения. Если пользователь (или сценарий JavaScript на странице) пытается перейти по URL-адресу, который не начинается с базового URL-адреса, переход не выполняется: 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(); } } } } htmlRender Сигнализирует, что визуализация содержимого объекта HTMLLoader полностью обновлена.flash.events.Event.HTML_RENDERflash.events.Event Сигнализирует, что визуализация содержимого объекта HTMLLoader полностью обновлена. Диспетчеризация этого события может выполняться довольно часто при любом изменении визуализации содержимого HTML. Например, диспетчеризация этого события выполняется при отображении нового содержимого после перехода по ссылке или визуализации содержимого HTML с помощью кода JavaScript. Слушатели событий могут вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader.

Обработчикам этого события следует проверить свойства contentWidth и contentHeight объекта HTMLLoader для обновления всех полос прокрутки, связанных с эти объектом.

complete Сигнализирует, что последняя операция загрузки, запрошенная методом loadString или load, завершена.flash.events.Event.COMPLETEflash.events.Event Сигнализирует, что последняя операция загрузки, запрошенная методом loadString или load, завершена. Диспетчеризация события выполняется после запуска события load кода JavaScript в модели HTML DOM объекта HTMLLoader. Передача события всегда выполняется асинхронно. Обработчик этого события может вызывать любой метод или получать доступ к любому свойству объекта HTMLLoader. HTMLLoader Создает объект HTMLLoader. Создает объект HTMLLoader. cancelLoad Отменяет любую выполняющуюся операцию загрузки. Отменяет любую выполняющуюся операцию загрузки. createRootWindow Создает новый объект NativeWindow, который содержит объект HTMLLoader.Новый объект HTMLLoader на этапе создания объекта NativeWindow. flash.html:HTMLLoadervisibleBooleantrueУказывает, является ли окно видимым. windowInitOptionsflash.display:NativeWindowInitOptionsnullЗадает параметры инициализации окна; если задано значение null, используются значения NativeWindowInitOptions по умолчанию. scrollBarsVisibleBooleantrueЗадает, будут ли в окне доступны полосы прокрутки. boundsflash.geom:RectanglenullЕсли задано значение null, устанавливает границы окна. Если для любого свойства x, y, width или height задано значение NaN, для соответствующего измерения окна сохраняется значение по умолчанию. Создает новый объект NativeWindow, который содержит объект HTMLLoader. Используйте объект HTMLLoader, возвращенный эти методом, для загрузки содержимого HTML.

По умолчанию (если при вызове этого метода параметры не передаются) в новом окне используется стандартный системный Chrome и добавляются полосы прокрутки содержимого. Можно настроить параметры для изменения свойств нового окна.

По мере того как окно загружает содержимое и применяет таблицы стилей, могут возникать незначительные графические искажения. Чтобы предотвратить их отображение, задайте свойству visible значение false. После завершения загрузки и размещения содержимого в окне, его можно сделать видимым, изменив значение свойства window.nativeWindow.visible на true или вызвав метод window.nativeWindow.activate().

getHistoryAt Возвращает запись журнала в заданном положении.Объект URLRequest для записи журнала в заданном положении. flash.html:HTMLHistoryItempositionuintПозиция в журнале. Возвращает запись журнала в заданном положении. historyBack По возможности выполняет обратный переход в журнале браузера. По возможности выполняет обратный переход в журнале браузера.

Вызов этого метода объекта HTMLLoader аналогичен вызову метода back() свойства window.history в сценарии JavaScript на странице HTML.

Эта функция не приводит к возникновению ошибок.

historyForward По возможности выполняет переход вперед в журнале браузера. По возможности выполняет переход вперед в журнале браузера.

Вызов этого метода объекта HTMLLoader аналогичен вызову метода forward() свойства window.history в сценарии JavaScript на странице HTML.

Эта функция не приводит к возникновению ошибок.

historyGo Выполняет переход на заданное число шагов в журнале браузера.stepsintЧисло шагов в журнале, на которое необходимо выполнить переход вперед (положительное число) или назад (отрицательное число). Выполняет переход на заданное число шагов в журнале браузера. Если число положительное, выполняется переход вперед, если отрицательное — назад. Если для перехода указано нулевое число шагов, выполняется перезагрузка.

Вызов этого метода эквивалентен вызову метода go() свойства window.history в сценарии JavaScript на странице HTML.

Эта функция не приводит к возникновению ошибок.

loadString Загружает объект HTMLLoader с содержимым HTML в строке HTML.htmlContentStringСтрока с содержимым HTML, которую необходимо загрузить в объект HTMLLoader. Загружает объект HTMLLoader с содержимым HTML в строке HTML. По завершении визуализации содержимого HTML в строке выполняется диспетчеризация события complete. Диспетчеризация события complete всегда выполняется асинхронно.

Вызов этого метода неявно отменяет любую предыдущую ожидающую операцию загрузки, инициированную этим методом или методом load(). Событие complete для предыдущей операции загрузки не будет доставлено.

Если в содержимом HTML, указанном в строке, отсутствует ссылка на внешние ресурсы, этот метод выполняет синхронную визуализацию содержимого HTML. Однако диспетчеризация события complete выполняется асинхронно. Если свойству loaded этого класса сразу после вызова этой функции задано значение true, это означает, что содержимое HTML, указанное в аргументе htmlContent, было визуализировано синхронно.

Возможно, что событие complete не будет доставлено. Это происходит, когда не удается полностью загрузить содержимое HTML в объект HTMLLoader. Причиной может быть то, что содержимое HTML ссылается на URL-адрес сценария CGI, постоянно создающий новое содержимое.

Содержимое, загруженное с помощью метода loadString(), помещается в изолированную программную среду безопасности приложения, только если свойство placeLoadStringContentInApplicationSandbox имеет значение true.

load Загружает объект HTMLLoader с данными с узла, заданного параметром urlRequestToLoad.urlRequestToLoadflash.net:URLRequestОбъект URLRequest, в котором содержатся данные о загружаемом указателе URL. Кроме загружаемого указателя URL, в объекте URLRequest содержатся свойства, которые определяют метод отправки формы HTTP (GET или POST), любые данные, которые будут переданы в запросе, и заголовки запросов. Загружает объект HTMLLoader с данными с узла, заданного параметром urlRequestToLoad. При вызове этого метода для свойства loaded изначально настраивается значение false. Этот метод инициирует операцию, которая всегда выполняется асинхронно.

Вызов этого метода неявно отменяет любую предыдущую ожидающую операцию загрузки, инициированную этим методом или методом loadString(). Событие complete для предыдущей операции загрузки не будет доставлено.

reload Повторно загружает страницу из текущего положения. Повторно загружает страницу из текущего положения. authenticate Задает обработку запросов аутентификации (true) или ее отсутствие (false) для запросов HTTP, отправленных этим объектом.Booleaninitialized from URLRequestDefaults.authenticate Задает обработку запросов аутентификации (true) или ее отсутствие (false) для запросов HTTP, отправленных этим объектом. Если задано значение false, при выполнении заданий аутентификации возвращается ошибка HTTP. cacheResponse Задает необходимость кэширования данных успешных ответов для запросов HTTP, отправленных этим объектом.Booleaninitialized from URLRequestDefaults.cacheResponse Задает необходимость кэширования данных успешных ответов для запросов HTTP, отправленных этим объектом. Если задано значение true, в объекте HTMLLoader используется кэш HTTP операционной системы. contentHeight Высота содержимого HTML (в пикселях).Number Высота содержимого HTML (в пикселях). Это свойство можно изменить аналогичным изменению размеров объекта HTMLLoader способом. Например, на странице HTML часто используется полное значение высоты объекта HTMLLoader, и свойство contentHeight может измениться при изменении высоты объекта HTMLLoader. contentWidth Ширина содержимого HTML (в пикселях).Number Ширина содержимого HTML (в пикселях). Это свойство можно изменить аналогичным изменению размеров объекта HTMLLoader способом. Например, на странице HTML часто используется полное значение ширины объекта HTMLLoader, и свойство contentWidth может измениться при изменении ширины объекта HTMLLoader. hasFocusableContent Определяет, является ли какое-либо содержимое в объекте HTMLLoader фокусируемым.Boolean Определяет, является ли какое-либо содержимое в объекте HTMLLoader фокусируемым. height Задает высоту прямоугольника холста HTML, подлежащего визуализации.Number Задает высоту прямоугольника холста HTML, подлежащего визуализации. Это свойство обозначает высоту экранного объекта HTMLLoader в пикселах. Максимальное значение свойства height составляет 4 095 пикселов. При изменении этого свойства в объекте HTMLLoader выполняется повторная визуализация документа HTML. Диспетчеризация событий htmlBoundsChanged может выполняться при изменении этого свойства.

При настройке свойства width или height объекта HTMLLoader границы объекта изменяются, но содержимое не масштабируется (так же происходит с другими типами экранных объектов).

historyLength Полная длина списка журнала, включая предыдущие и последующие записи.uint Полная длина списка журнала, включая предыдущие и последующие записи. Для этого свойства установлено такое же значение, что и для свойства window.history.length JavaScript страницы HTML. historyPosition Текущее положение в журнале.uint Текущее положение в журнале. Список журнала соответствует объекту window.history страницы HTML. Записи, расположенные перед текущим положением, называются предыдущим списком; записи после текущего положения называются последующим списком. При попытке настроить положение после конечных записей задается положение в конце списка. htmlHost Объект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title объекта HTMLLoader.flash.html:HTMLHostОбъект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title объекта HTMLLoader. Объект HTMLHost, использующийся для обработки изменений определенных элементов пользовательского интерфейса, таких как свойство window.document.title объекта HTMLLoader. Для переопределения поведения по умолчанию объекта HTMLLoader создайте подкласс класса HTMLHost и переопределите функции его членов для обработки различных изменений пользовательского интерфейса в содержимом HTML. idleTimeout Указывает значение для времени ожидания активности (в миллисекундах) для запросов HTTP, отправленных данным объектом.Numberinitialized from URLRequestDefaults.idleTimeout Указывает значение для времени ожидания активности (в миллисекундах) для запросов HTTP, отправленных данным объектом.

Время ожидания покоя — это количество времени, в течение которого клиент ожидает ответ от сервера после установки подключения до прерывания обработки запроса.

isSupported Указывает, поддерживается ли класс HTMLLoader в клиентской системе.3.0 Boolean Указывает, поддерживается ли класс HTMLLoader в клиентской системе. loaded Обозначает, было ли доставлено событие загрузки JavaScript, соответствующее предыдущему вызову метода load() или loadString(), в HTML DOM в объекте HTMLLoader.Boolean Обозначает, было ли доставлено событие загрузки JavaScript, соответствующее предыдущему вызову метода load() или loadString(), в HTML DOM в объекте HTMLLoader. Это свойство имеет значение true перед передачей отправкой complete. Настройка для этого свойства значения true может быть невозможна. Причины аналогичны тем, по которым невозможно выполнить диспетчеризацию события complete. location Указатель URL для содержимого, загруженного в объект HTMLLoader.String Указатель URL для содержимого, загруженного в объект HTMLLoader. manageCookies Задает необходимость управления стеком протоколов HTTP файлами cookie для данного объекта.Booleaninitialized from URLRequestDefaults.manageCookies Задает необходимость управления стеком протоколов HTTP файлами cookie для данного объекта. Если задано значение true, файлы cookie добавляются в запрос, а файлы cookie, содержащиеся в ответе, сохраняются. Если задано значение false, файлы cookie не добавляются в запрос, а файлы cookie, содержащиеся в ответе, не сохраняются. navigateInSystemBrowser Задает, необходимо ли при переходе в корневом фрейме содержимого HTML (например, при переходе по ссылке, если задано свойство window.location, или вызове метода window.open()) выполнять переход в объекте HTMLLoader (false) или системном браузере по умолчанию (true).Booleanfalse Необходимо ли при переходе в корневом фрейме объекта HTML выполнять переход в объекте HTMLLoader (false) или системном браузере по умолчанию (true). Задает, необходимо ли при переходе в корневом фрейме содержимого HTML (например, при переходе по ссылке, если задано свойство window.location, или вызове метода window.open()) выполнять переход в объекте HTMLLoader (false) или системном браузере по умолчанию (true). При необходимости выполнения всех переходов в системном браузере (а не в объекте HTMLLoader) настройте для этого свойства значение true. paintsDefaultBackground Определяет, является ли фон документа HTMLLoader белым непрозрачным (true) или нет (false).BooleanОпределяет, является ли фон документа HTMLLoader белым непрозрачным (true) или нет (false). Определяет, является ли фон документа HTMLLoader белым непрозрачным (true) или нет (false). Если для этого свойства задано значение false, в объекте HTMLLoader используются контейнер экранного объекта в качестве фона для содержимого HTML и свойство непрозрачности (значение alpha) контейнера экранного объекта в качестве фона содержимого HTML. Однако, если для элемента body или любого другого элемента документа HTML настроен непрозрачный цвет фона (может быть определен строкой style="background-color:gray"), для части представленного содержимого HTML используется заданный непрозрачный цвет фона. pdfCapability Тип поддержки PDF в пользовательской системе, определенный как целочисленное кодовое значение.int Тип поддержки 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. В этом случае, если для свойства pdfCapability задано значение PDFCapability.STATUS_OK, то при попытке загрузки приложением AIR содержимого PDF, Acrobat или Adobe Reader более ранней версии отображает предупреждение (в среде программы AIR сообщение об ошибке не отображается). При угрозе возникновения такой ситуации проинструктируйте пользователей, что при запуске данного приложения необходимо закрыть Acrobat или Adobe Reader. Рассмотрите возможность вывода этих инструкций на экран, если загрузка содержимого PDF не выполняется за приемлемое время.

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. placeLoadStringContentInApplicationSandbox Указывает, куда будет помещено содержимое, загруженное с помощью метода loadString(): в изолированную программную среду приложения (true) или в другую изолированную программную среду (false).Booleanfalse Указывает, куда будет помещено содержимое, загруженное с помощью метода 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(), помещается в изолированную программную среду приложения.

runtimeApplicationDomain Программный домен, который необходимо использовать для объекта window.runtime в сценарии JavaScript на странице HTML.flash.system:ApplicationDomainесли объект ApplicationDomain находится в защищенном домене, отличном от домена вызывающего метода. SecurityErrorSecurityErrorПрограммный домен, который необходимо использовать для объекта window.runtime в сценарии JavaScript на странице HTML. Программный домен, который необходимо использовать для window.runtime в сценарии JavaScript на странице HTML.

Если значение равно null или если HTML-содержимое происходит из домена защиты, отличного от домена защиты SWF-содержимого, содержащего объект HTMLLoader, для страницы используется домен приложений по умолчанию.

scrollH Горизонтальное положение прокрутки содержимого HTML в объекте HTMLLoader.Number Горизонтальное положение прокрутки содержимого HTML в объекте HTMLLoader. scrollV Вертикальное положение прокрутки содержимого HTML в объекте HTMLLoader.Number Вертикальное положение прокрутки содержимого HTML в объекте HTMLLoader. swfCapability Тип поддержки SWF в системе пользователя, представленный в виде целочисленного кода.int Тип поддержки 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. textEncodingFallback Кодировка символов, используемая содержимым HTMLLoader, если кодировка символов не задана страницей HTML.String Кодировка символов, используемая содержимым HTMLLoader, если кодировка символов не задана страницей HTML. На странице HTML кодировка символов задается в теге meta, как показано ниже: <meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

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

Если кодировка не задана страницей HTML, свойством textEncodingFallback или свойством textEncodingOverride, в содержимом HTML используется кодировка ISO-8859-1.

textEncodingOverride Кодировка символов, используемая в содержимом HTMLLoader, перезаписывает любой параметр на странице HTML.String Кодировка символов, используемая в содержимом HTMLLoader, перезаписывает любой параметр на странице HTML. На странице HTML кодировка символов задается в теге meta, как показано ниже: <meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

Этот параметр также перезаписывает любой параметр в свойстве textEncodingFallback.

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

Настройте свойство textEncodingOverride после загрузки содержимого HTML для выполнения обновления AIR содержимого HTML с использованием заданной кодировки. После выполнения перехода к новой странице в объекте HTMLLoader необходимо повторно настроить это свойство, чтобы на новой странице использовалась заданная кодировка.

При настройке для свойства textEncodingOverride значения null восстанавливается режим по умолчанию.

useCache Задает необходимость обращения к локальному кэшу перед тем, как запросы HTTP, отправленные этим объектом, начнут извлекать данные.Booleaninitialized from URLRequestDefaults.useCache Задает необходимость обращения к локальному кэшу перед тем, как запросы HTTP, отправленные этим объектом, начнут извлекать данные. userAgent Строка агента пользователя, которую необходимо использовать в любых последующих запросах содержимого из данного объекта HTMLLoader.String Строка агента пользователя, которую необходимо использовать в любых последующих запросах содержимого из данного объекта 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.5
Mozilla/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

width Задает ширину прямоугольника холста HTML, подлежащего визуализации.Number Задает ширину прямоугольника холста HTML, подлежащего визуализации. Это ширина экранного объекта HTMLLoader в пикселях. Максимальное значение свойства width составляет 4 095 пикселов. При изменении этого свойства в объекте HTMLLoader выполняется повторная визуализация документа HTML. Диспетчеризация событий htmlBoundsChange может выполняться при изменении этого свойства. При настройке свойств width и height объекта HTMLLoader границы объекта изменяются, но содержимое не масштабируется (так же происходит с другими типами экранных объектов). window Глобальный объект JavaScript для содержимого, загруженного в управляющий элемент HTML.Object Глобальный объект JavaScript для содержимого, загруженного в управляющий элемент HTML. HTMLWindowCreateOptions Этот класс определяет параметры, которые могут быть заданы, когда сценарий JavaScript, выполняющийся в объекте HTMLLoader, пытается создать новое окно HTML с помощью вызова метода window.open().Object Этот класс определяет параметры, которые могут быть заданы, когда сценарий JavaScript, выполняющийся в объекте HTMLLoader, пытается создать новое окно HTML с помощью вызова метода window.open().

Этот класс определяет свойства и методы, соответствующие параметрам в параметре features, передаваемом в метод window.open() в сценарии JavaScript.

Например, в сценарии JavaScript в документе HTML (объект HTMLLoader) может содержаться следующий вызов метода window.open(), в котором в параметре features (третий параметр) перечислены несколько параметров:

window.open("http://www.adobe.com", "AdobeWindow", "scrollbars=1,menubar=1,location=0,status=0")

Класс HTMLWindowCreateOptions используется при перезаписи метода createWindow() подкласса класса HTMLHost. Объект HTMLLoader передает объект HTMLWindowCreateOptions в качестве параметра windowCreateOptions метода createWindow() объекта HTMLHost.

fullscreen Задает необходимость отображения окна во весь экран.falseBoolean Задает необходимость отображения окна во весь экран. Для этого свойства задано значение true, если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение "fullscreen", "fullscreen=1" или "fullscreen=y". height Задает необходимую первоначальную высоту нового окна.NaNNumber Задает необходимую первоначальную высоту нового окна. Настроено значение параметра height в строке features сценария JavaScript, вызывающего метод window.open(). Если задано значение NaN (устанавливается по умолчанию, если значение height в строке features не задано), используется стандартная высота окна. locationBarVisible Задает необходимость отображения панели расположения.falseBoolean Задает необходимость отображения панели расположения. Для этого свойства задано значение true если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение location, location=1 или location=y. menuBarVisible Задает необходимость отображения строки меню.falseBoolean Задает необходимость отображения строки меню. Для этого свойства задано значение true если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение menubar, menubar=1 или menubar=y. resizable Определяет, можно ли изменять размер окна.falseBoolean Определяет, можно ли изменять размер окна. Для этого свойства задано значение true если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение resizable, resizable=1 или resizable=y. scrollBarsVisible Задает необходимость отображения полос прокрутки.trueBoolean Задает необходимость отображения полос прокрутки. Для этого свойства задано значение true, если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение scrollbars, scrollbars=1 или scrollbars=y. statusBarVisible Задает необходимость отображения строки состояния.falseBoolean Задает необходимость отображения строки состояния. Для этого свойства задано значение true если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение status, status=1 или status=y. toolBarVisible Задает необходимость отображения панели управления.falseBoolean Задает необходимость отображения панели управления. Для этого свойства задано значение true если в строке features сценария JavaScript, вызывающего метод window.open(), содержится значение toolbar, toolbar=1 или toolbar=y. width Задает необходимую первоначальную ширину нового окна.NaNNumber Задает необходимую первоначальную ширину нового окна. Настроено значение параметра width в строке features сценария JavaScript, вызывающего метод window.open(). Если задано значение NaN (устанавливается по умолчанию, если значение width в строке features не задано), используется стандартная ширина окна. x Задает необходимое первоначальное положение по оси x нового окна на экране.NaNNumber Задает необходимое первоначальное положение нового окна на экране по оси x. Настроено значение, заданное для параметра left или screenX в строке features сценария JavaScript, в котором вызывается метод window.open(). Если задано значение NaN, по умолчанию, если значение left или screenX в строке features не настроено, для окна используется стандартное положение по оси x. y Задает необходимое первоначальное положение по оси y нового окна на экране.NaNNumber Задает необходимое первоначальное положение нового окна на экране по оси y. Настроено значение, заданное для параметра top или screenY в строке features сценария JavaScript, в котором вызывается метод window.open(). Если задано значение NaN, по умолчанию, если значение left или screenX в строке features не настроено, для окна используется стандартное положение по оси x.