HTMLLoader  - AS3

指定是否应为此对象发出的 HTTP 请求处理验证请求，如果是，则为 true，否则为 false。如果为 false，则验证挑战返回 HTTP 错误。

默认值为 initialized from URLRequestDefaults.authenticate。

相关 API 元素

指定是否应为此对象发出的 HTTP 请求缓存成功的响应数据。设置为 true 时，HTMLLoader 对象将使用操作系统的 HTTP 缓存。

默认值为 initialized from URLRequestDefaults.cacheResponse。

相关 API 元素

HTML 内容的高度（以像素为单位）。此属性可以随着 HTMLLoader 对象尺寸的更改而更改。例如，HTML 页通常使用 HTMLLoader 对象的整个高度，如果更改 HTMLLoader 对象的高度，则 contentHeight 属性可能会发生更改。

HTML 内容的宽度（以像素为单位）。此属性可以随着 HTMLLoader 对象尺寸的更改而更改。例如，HTML 页通常使用 HTMLLoader 对象的整个宽度，如果更改 HTMLLoader 对象的宽度，则 contentWidth 属性可能会发生更改。

表示 HTMLLoader 对象中的任何内容是否可获得焦点。

指定所呈现的 HTML 画布的矩形高度。此属性值是 HTMLLoader 显示对象的高度（以像素为单位）。height 的最大值为 4095 像素。更改此属性将导致 HTMLLoader 对象重新呈现 HTML 文档。可以调度 htmlBoundsChanged 事件以响应此属性的更改。

在设置 HTMLLoader 对象的 width 或 height 属性时，该对象的范围将发生更改，但内容不会缩放（其他类型的显示对象将会发生缩放）。

历史记录列表的总长度，包括向后和向前的条目。此属性具有与 HTML 页的 window.history.length JavaScript 属性相同的值。

相关 API 元素

历史记录列表中的当前位置。历史记录列表对应于 HTML 页的 window.history 对象。低于当前位置的条目为“向前”列表，高于当前位置的条目为“向后”列表。尝试将位置设置在末尾以外的会将位置设置到末尾处。

相关 API 元素

用于处理某些用户界面元素更改的 HTMLHost 对象，如 HTMLLoader 对象的 window.document.title 属性。若要覆盖 HTMLLoader 对象的默认行为，请创建 HTMLHost 类的一个子类，然后覆盖其成员函数以处理 HTML 内容中的各种用户界面更改。

相关 API 元素

指定此对象发出的 HTTP 请求的空闲超时值（以毫秒为单位）。

空闲超时值是指客户端在建立连接之后、放弃请求之前等待服务器响应的时间。

默认值为 initialized from URLRequestDefaults.idleTimeout。

相关 API 元素

表示客户端系统是否支持 HTMLLoader 类。

表示与先前调用 load() 或 loadString() 方法相对应的 JavaScript load 事件是否已传送到 HTMLLoader 对象中的 HTML DOM。调度 complete 事件之前，此属性为 true。此属性有可能永远也不会变为 true。在从来不调度 complete 事件的情况下也会发生这种情况。

在 HTMLLoader 对象中加载的内容的 URL。

指定 HTTP 协议堆栈是否应管理此对象的 cookie。如果为 true，则将 cookie 添加到请求中并记住响应 cookie。如果为 false，则不 将 cookie 添加到请求中且不 记住响应 cookie。

默认值为 initialized from URLRequestDefaults.manageCookies。

相关 API 元素

指定 HTML 内容根帧的导航（如用户单击链接时、设置 window.location 属性时或调用 window.open() 时）是导致在 HTMLLoader 对象中导航 (false) 还是在默认系统 Web 浏览器中导航 (true)。如果希望所有导航都在系统 Web 浏览器中（而不是在 HTMLLoader 对象中）进行，请将此属性设置为 true。

默认值为 false。

指定 HTMLLoader 文档背景是否为不透明白色，如果是，则为 true，否则为 false。如果将此属性设置为 false，HTMLLoader 对象将使用其显示对象容器作为 HTML 的背景，而 HTML 将使用显示对象容器的不透明度（alpha 值）作为 HTML 背景。但是，如果 HTML 文档的 body 元素或任何其他元素具有不透明背景颜色（例如，由 style="background-color:gray" 指定），则所呈现的 HTML 部分将使用指定的不透明背景颜色。

用户系统上的 PDF 支持类型，它被定义为整数代码值。只有在此属性的计算结果为 PDFCapability.STATUS_OK 时，HTMLLoader 对象才能显示 PDF 内容。PDFCapability 类定义用作 pdfCapability 属性的可能值的常数，如下所示：

相关 API 元素

指定通过 loadString() 方法加载的内容放置在应用程序沙箱中 (true) 还是非应用程序沙箱中 (false)。

将此属性设置为 false 时，通过 loadString() 方法加载的内容放置在具有以下特征的非应用程序沙箱中：

• 它有权从网络加载内容（但不能从文件系统加载）。
• 无法使用 XMLHttpRequest 加载数据。
• window.location 属性设置为 "about:blank"。
• 内容无法访问 window.runtime 属性（如同任何非应用程序沙箱中的内容）。

将此属性设置为 true 时，通过 loadString() 方法加载的内容放置在应用程序沙箱中，并有权访问 window.runtime 属性和所有 AIR API。您应该确保调用 loadString() 方法过程中使用的字符串的数据源受信任。此属性设置为 true 时，将以完整的应用程序权限执行 HTML 字符串中的代码语句。只有在确定字符串不会包含有害代码时，才应该将此属性设置为 true。

在用 AIR 1.0 或 AIR 1.1 SDK 编译的应用程序中，通过 loadString() 方法加载的内容放置在应用程序沙箱中。

默认值为 false。

相关 API 元素

用于 HTML 页的 JavaScript 中的 window.runtime 对象的应用程序域。

如果为 null，或者如果 HTML 内容来自与包含 HTMLLoader 对象的 SWF 内容不同的另一个安全域，则页面将对页面域使用默认的应用程序域。

相关 API 元素

HTMLLoader 对象中的 HTML 内容的水平滚动位置。

HTMLLoader 对象中的 HTML 内容的垂直滚动位置。

用户系统上的 SWF 支持类型，它被定义为整数代码值。只有在此属性的计算结果为 HTMLSWFCapability.STATUS_OK 时，HTMLLoader 对象才能显示 SWF 内容。HTMLSWFCapability 类为 swfCapability 属性的可能值定义常量，如下所示：

相关 API 元素

在 HTML 页未指定字符编码时 HTMLLoader 内容使用的字符编码。HTML 页在 meta 标记中指定字符编码，如下所示：

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

在 有效的字符集 的 IANA 列表中定义值。

如果 HTML 页、textEncodingFallback 属性或 textEncodingOverride 属性未指定编码，则 HTML 内容将使用 ISO-8859-1 编码。

相关 API 元素

HTMLLoader 内容使用的字符编码，它将覆盖 HTML 页中的任何设置。HTML 页在 meta 标记中指定字符编码，如下所示：

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

此设置也覆盖 textEncodingFallback 属性中的任何设置。

在 有效的字符集 的 IANA 列表中定义值。

加载 HTML 内容后设置 textEncodingOverride 属性可以让 AIR 使用指定编码刷新 HTML 内容。HTMLLoader 导航到新页面后，如果希望新页面使用特定编码，则需要再次设置此属性。

如果 HTML 页、textEncodingFallback 属性或 textEncodingOverride 属性未指定编码，则 HTML 内容将使用 ISO-8859-1 编码。

将 textEncodingOverride 属性设置为 null 可恢复默认行为。

相关 API 元素

指定在此对象发出的 HTTP 请求获取数据之前是否应查询本地缓存。

默认值为 initialized from URLRequestDefaults.useCache。

相关 API 元素

来自此 HTMLLoader 对象的任何后续内容请求中使用的用户代理字符串。

要设置用户代理字符串，请在调用 load() 方法之前设置 HTMLLoader 对象的 userAgent 属性。不 使用传递到 load() 方法的 URLRequest 对象的 userAgent 属性。

通过设置 URLRequestDefaults.userAgent 属性，可以设置应用程序域中所有 HTMLLoader 对象使用的默认用户代理字符串。如果未为 HTMLLoader 对象的 userAgent 属性设置值（或者将该值设置为 null），则会将用户代理字符串设置为静态 URLRequestDefaults.userAgent 属性的值。

如果既未为 HTMLLoader 的 userAgent 属性设置值，也未为 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"

相关 API 元素

指定所呈现的 HTML 画布的矩形宽度。这是 HTMLLoader 显示对象的宽度（以像素为单位）。width 的最大值是 4095 像素。更改此属性将导致 HTMLLoader 对象重新呈现 HTML 文档。可以调度 htmlBoundsChange 事件以响应此属性的更改。在设置 HTMLLoader 对象的 width 和 height 属性时，该对象的范围将发生更改，但内容不会缩放（其他类型的显示对象将会发生缩放）。

加载到 HTML 控件中的内容的全局 JavaScript 对象。

创建 HTMLLoader 对象。

取消正在进行的任何加载操作。

创建新的 NativeWindow 对象，其中包含 HTMLLoader 对象。使用由此方法返回的 HTMLLoader 对象可加载 HTML 内容。

默认情况下（在调用此方法时不设置任何参数），新窗口将使用标准系统镶边并对内容包括滚动条控件。可以设置参数以更改新窗口的属性。

随着窗口加载内容并应用样式表，可能会发生较小的图形故障。要防止此类不连续性可见，请将 visible 参数设置为 false。当窗口加载和布置其内容后，可以通过将 window.nativeWindow.visible 属性设置为 true 来显示该内容或调用 window.nativeWindow.activate() 方法。

参数

返回指定位置的历史记录条目。

参数

相关 API 元素

如果可能，在浏览器历史记录中向后浏览。

调用 HTMLLoader 对象的此方法与调用 HTML 页中 JavaScript 中的 window.history 属性的 back() 方法具有相同的效果。

此函数不引发错误。

相关 API 元素

如果可能，在浏览器历史记录中向前浏览。

调用 HTMLLoader 对象的此方法与调用 HTML 页中 JavaScript 中的 window.history 属性的 forward() 方法具有相同的效果。

此函数不引发错误。

相关 API 元素

在浏览器历史记录中浏览指定的步骤数。如果为正数，则向前导航；如果为负数，则向后导航。零导航强制重新加载。

此方法等效于调用 HTML 页中 JavaScript 中的 window.history 属性的 go() 方法。

此函数不引发错误。

参数

相关 API 元素

使用 urlRequestToLoad 参数指定的站点中的数据加载 HTMLLoader 对象。初始调用此方法时会将 loaded 属性设置为 false。此方法启动一个始终异步完成的操作。

调用此方法可隐式取消用此方法或 loadString() 方法初始化的任何先前未处理的加载操作。永远不会传送先前加载操作的 complete 事件。

有可能永远不会传送 complete 事件。如果加载到 HTMLLoader 对象中的任何 HTML 内容不能完全下载，则会发生这种情况。如果 HTML 内容引用了到无限反复生成内容的 CGI 脚本的 URL，则会发生这种情况。

参数

相关 API 元素

使用 HTML 字符串中包含的 HTML 内容加载 HTMLLoader 对象。当字符串中的 HTML 呈现完毕时，将调度 complete 事件。complete 事件始终异步调度。

调用此方法可隐式取消用此方法或 load() 方法初始化的任何先前未处理的加载操作。永远不会传送先前加载操作的 complete 事件。

如果字符串中指定的 HTML 不引用外部资源，则此方法将同步呈现 HTML。不过，complete 事件仍将异步调度。如果此类的 loaded 属性为 true，则在调用此函数后，会立即同步呈现 htmlContent 参数中指定的 HTML 内容。

有可能永远不会传送 complete 事件。如果加载到 HTMLLoader 对象中的任何 HTML 内容不能完全下载，则会发生这种情况。如果 HTML 内容引用了到无限反复生成内容的 CGI 脚本的 URL，则会发生这种情况。

只有在将 placeLoadStringContentInApplicationSandbox 属性设置为 true 时，通过 loadString() 方法加载的内容才会放置在应用程序安全沙箱中。

参数

相关 API 元素

从当前位置重新加载页面。

指出 loadString 或 load 方法上次请求的加载操作已完成。对 HTMLLoader 对象中的 HTML DOM 引发 JavaScript load 事件之后 调度此事件。此事件始终异步调度。此事件的事件处理函数可以调用 HTMLLoader 对象的任何方法或访问该对象的任何属性。

此事件具有以下属性：

相关 API 元素

指出 HTMLLoader 对象的 contentWidth 和/或 contentHeight 属性已发生更改。例如，这可能是加载新图像或其他内容的结果。事件处理函数可以调用 HTMLLoader 对象的任何方法或访问该对象的任何属性。

HTMLLoader 对象可以在加载操作初始化后的任何时间，甚至是在已调度 complete 事件后，调度此事件。

此事件具有以下属性：

相关 API 元素

指出已创建 HTML DOM 以响应加载操作。在调度此事件时，HTMLLoader 对象的 load() 和 loadString() 方法将引发异常。在调度此事件时，可从 HTMLLoader 对象（控制 HTMLLoader 对象中加载的 URL）的 window 属性访问的任何 JavaScript 对象的任何属性或方法在进行设置或调用时会引发异常。例如，通过设置 HTMLLoader 对象的 window 属性来设置 window.location 会导致 JavaScript 异常。

此事件具有以下属性：

相关 API 元素

指出 HTMLLoader 对象中的内容呈现完全处于最新状态。可以相当频繁地调度此事件，即每当对 HTML 内容进行任何呈现更改时。例如，当因为用户单击某一链接而显示新内容或页面中的 JavaScript 呈现 HTML 时，将调度此事件。事件侦听器可以调用 HTMLLoader 对象的任何方法或访问其任何属性。

此事件的处理函数应该检查 HTMLLoader 对象的 contentWidth 和 contentHeight 属性以更新与该对象相关联的任何滚动条。

HTMLLoader 对象可以在加载操作初始化后的任何时间，甚至是在已调度 complete 事件后，调度此事件。

此事件具有以下属性：

指出更改了 HTMLLoader 对象的 location 属性。此事件的事件处理函数可以调用 HTMLLoader 对象的任何方法或访问该对象的任何属性。

在使用 AIR 命名空间 2.7 和更高版本的应用程序中，HTMLLoader 调度 LocationChangeEvent 类型的 locationChange 事件。在 AIR 早期版本中，调度的事件对象是 Event 类的一个实例。

相关 API 元素

指出更改了 HTMLLoader 对象的 location 属性。此事件的事件处理函数可以调用 HTMLLoader 对象的任何方法或访问该对象的任何属性。

在使用低于 2.7 版本的 AIR 命名空间的应用程序中，HTMLLoader 调度 Event 类型的 locationChange 事件。在 AIR 2.7 和更高版本中，事件对象是 LocationChangeEvent 类的一个实例，该类为新的页面 URL 提供了一个附加的 location 属性集。

此事件具有以下属性：

相关 API 元素

表示 HTMLLoader 对象的 location 属性即将更改。

仅当通过用户交互（如在用户单击一个链接时）或者由 HTMLLoader 内部运行的代码（如客户端重定向）启动位置更改时才调度 locationChanging 事件。默认情况下，新位置在此 HTMLLoader 对象中显示。您可以调用事件对象的 preventDefault() 方法取消默认行为。例如，您可以使用 flash.net.navigateToURL() 函数在基于事件对象的 location 属性的系统浏览器中打开页面。

当调用下列方法时，不会调度 locationChanging() 事件：

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

此外，当 navigateInSystemBrowser 属性为 true 并且在系统浏览器中打开了目标页面时，不会调度此事件，原因是 HTMLLoader 位置未更改。

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();
            }
        }
    }
}

指出 scrollH 或 scrollV 属性已被 HTMLLoader 对象更改。当 HTMLLoader 对象中运行的 JavaScript 调用 window 对象的 scrollTo() 方法且需要的位置尚不可见时，HTMLLoader 对象调度此事件。当 ActionScript 代码更改 scrollH 或 scrollV 属性时，不调度此事件。事件处理函数可以调用 HTMLLoader 对象的任何方法或访问该对象的任何属性。

此事件的事件处理函数应该检查 scrollH 和 scrollV 属性以更新与 HTMLLoader 对象相关联的任何滚动条。

HTMLLoader 对象可以在加载操作初始化后的任何时间，甚至是在已调度 complete 事件后，调度此事件。

此事件具有以下属性：

指出在 HTMLLoader 对象中发生了未捕获的 JavaScript 异常。事件处理函数可以调用 HTMLLoader 对象的任何方法或访问该对象的任何属性。该事件可以取消，在 AIR Debug Launcher 中运行时，其默认行为是将 JavaScript 堆栈发送到跟踪输出。

此事件具有以下属性：

相关 API 元素