ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Scripting the AIR HTML Container
About extending the HTMLHost class
Adobe AIR 1.0 and later
If, for example, your application presents multiple HTMLLoader objects in a tabbed interface, you may want title
changes made by the loaded HTML pages to change the label of the tab, not the title of the main window. Similarly,
your code could respond to a window.moveTo() call by repositioning the HTMLLoader object in its parent display
object container, by moving the window that contains the HTMLLoader object, by doing nothing at all, or by doing
something else entirely.
The AIR HTMLHost class controls the following JavaScript properties and methods:
window.status
window.document.title
window.location
window.blur()
window.close()
window.focus()
window.moveBy()
window.moveTo()
window.open()
window.resizeBy()
window.resizeTo()
When you create an HTMLLoader object using new HTMLLoader(), the listed JavaScript properties or methods are
not enabled. The HTMLHost class provides a default, browser-like implementation of these JavaScript APIs. You can
also extend the HTMLHost class to customize the behavior. To create an HTMLHost object supporting the default
behavior, set the defaultBehaviors parameter to true in the HTMLHost constructor:
var defaultHost:HTMLHost = new HTMLHost(true);
When you create an HTML window in AIR with the HTMLLoader class createRootWindow() method, an
HTMLHost instance supporting the default behaviors is assigned automatically. You can change the host object
behavior by assigning a different HTMLHost implementation to the htmlHost property of the HTMLLoader, or you
can assign null to disable the features entirely.
Note: AIR assigns a default HTMLHost object to the initial window created for an HTML-based AIR application and
any windows created by the default implementation of the JavaScript window.open() method.
Example: Extending the HTMLHost class
Adobe AIR 1.0 and later
The following example shows how to customize the way that an HTMLLoader object affects the user interface, by
extending the HTMLHost class:
Flex example:
1 Create a class that extends the HTMLHost class (a subclass).
Last updated 6/6/2012
1006