flash.html.HTMLLoader (Flex 3)

	属性	定义方
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	DisplayObject
		alpha : Number 指示指定对象的 Alpha 透明度值。	DisplayObject
		authenticate : Boolean 指定是否应为此对象发出的 HTTP 请求处理验证请求，如果是，则为 true，否则为 false。	HTMLLoader
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	DisplayObject
		buttonMode : Boolean 指定此 sprite 的按钮模式。	Sprite
		cacheAsBitmap : Boolean 如果设置为 true，则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。	DisplayObject
		cacheResponse : Boolean 指定是否应为此对象发出的 HTTP 请求缓存成功的响应数据。	HTMLLoader
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contentHeight : Number [只读 (read-only)] HTML 内容的高度（以像素为单位）。	HTMLLoader
		contentWidth : Number [只读 (read-only)] HTML 内容的宽度（以像素为单位）。	HTMLLoader
		contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。	InteractiveObject
		doubleClickEnabled : Boolean 指定此对象是否接收 doubleClick 事件。	InteractiveObject
		dropTarget : DisplayObject [只读 (read-only)] 指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。	Sprite
		filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。	DisplayObject
		focusRect : Object 指定此对象是否显示焦点矩形。	InteractiveObject
		graphics : Graphics [只读 (read-only)] 指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘画命令。	Sprite
		hasFocusableContent : Boolean [只读 (read-only)] 指示 HTMLLoader 对象中的任何内容是否可获得焦点。	HTMLLoader
		height : Number 指定所呈现的 HTML 画布的矩形高度。	HTMLLoader
		historyLength : uint [只读 (read-only)] 历史记录列表的总长度，包括向后和向前的条目。	HTMLLoader
		historyPosition : uint 历史记录列表中的当前位置。	HTMLLoader
		hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。	Sprite
		htmlHost : HTMLHost 用于处理某些用户界面元素更改的 HTMLHost 对象，如 HTMLLoader 对象的 window.document.title 属性。	HTMLLoader
		loaded : Boolean [只读 (read-only)] 指示与先前调用 load() 或 loadString() 方法相对应的 JavaScript load 事件是否已传送到 HTMLLoader 对象中的 HTML DOM。	HTMLLoader
		loaderInfo : LoaderInfo [只读 (read-only)] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	DisplayObject
		location : String [只读 (read-only)] 在 HTMLLoader 对象中加载的内容的 URL。	HTMLLoader
		manageCookies : Boolean 指定 HTTP 协议堆栈是否应管理此对象的 cookie。	HTMLLoader
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	DisplayObject
		mouseChildren : Boolean 确定对象的子项是否支持鼠标。	DisplayObjectContainer
		mouseEnabled : Boolean 指定此对象是否接收鼠标消息。	InteractiveObject
		mouseX : Number [只读 (read-only)] 指示鼠标位置的 x 坐标，以像素为单位。	DisplayObject
		mouseY : Number [只读 (read-only)] 指示鼠标位置的 y 坐标，以像素为单位。	DisplayObject
		name : String 指示 DisplayObject 的实例名称。	DisplayObject
		navigateInSystemBrowser : Boolean 指定 HTML 内容根帧的导航（如用户单击链接时、设置 window.location 属性时或调用 window.open() 时）是导致在 HTMLLoader 对象中导航 (false) 还是在默认系统 Web 浏览器中导航 (true)。	HTMLLoader
		numChildren : int [只读 (read-only)] 返回此对象的子项数目。	DisplayObjectContainer
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	DisplayObject
		paintsDefaultBackground : Boolean 指定 HTMLLoader 文档背景是否为不透明白色，如果是，则为 true，否则为 false。	HTMLLoader
		parent : DisplayObjectContainer [只读 (read-only)] 指示包含此显示对象的 DisplayObjectContainer 对象。	DisplayObject
		pdfCapability : int [静态] [只读 (read-only)] 用户系统上的 PDF 支持类型，它被定义为整数代码值。	HTMLLoader
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		root : DisplayObject [只读 (read-only)] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。	DisplayObject
		rotation : Number 指示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。	DisplayObject
		runtimeApplicationDomain : ApplicationDomain 用于 HTML 页的 JavaScript 中的 window.runtime 对象的应用程序域。	HTMLLoader
		scale9Grid : Rectangle 当前有效的缩放网格。	DisplayObject
		scaleX : Number 指示从注册点开始应用的对象的水平缩放比例（百分比）。	DisplayObject
		scaleY : Number 指示从对象注册点开始应用的对象的垂直缩放比例（百分比）。	DisplayObject
		scrollH : Number HTMLLoader 对象中的 HTML 内容的水平滚动位置。	HTMLLoader
		scrollRect : Rectangle 显示对象的滚动矩形范围。	DisplayObject
		scrollV : Number HTMLLoader 对象中的 HTML 内容的垂直滚动位置。	HTMLLoader
		soundTransform : SoundTransform 控制此 sprite 中的声音。	Sprite
		stage : Stage [只读 (read-only)] 显示对象的舞台。	DisplayObject
		tabChildren : Boolean 确定对象的子项是否支持 Tab 键。	DisplayObjectContainer
		tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。	InteractiveObject
		tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。	InteractiveObject
		textEncodingFallback : String 在 HTML 页未指定字符编码时 HTMLLoader 内容使用的字符编码。	HTMLLoader
		textEncodingOverride : String HTMLLoader 内容使用的字符编码，它将覆盖 HTML 页中的任何设置。	HTMLLoader
		textSnapshot : TextSnapshot [只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。	DisplayObjectContainer
		transform : Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	DisplayObject
		useCache : Boolean 指定在此对象发出的 HTTP 请求获取数据之前是否应查询本地缓存。	HTMLLoader
		useHandCursor : Boolean 布尔值，指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形（手形光标）。	Sprite
		userAgent : String 来自此 HTMLLoader 对象的任何后续内容请求中使用的用户代理字符串。	HTMLLoader
		visible : Boolean 显示对象是否可见。	DisplayObject
		width : Number 指定所呈现的 HTML 画布的矩形宽度。	HTMLLoader
		window : Object [只读 (read-only)] 加载到 HTML 控件中的内容的全局 JavaScript 对象。	HTMLLoader
		x : Number 指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。	DisplayObject
		y : Number 指示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。	DisplayObject

	方法	定义方
		HTMLLoader() 创建 HTMLLoader 对象。	HTMLLoader
		addChild(child:DisplayObject):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。	DisplayObjectContainer
		cancelLoad():void 取消正在进行的任何加载操作。	HTMLLoader
		contains(child:DisplayObject):Boolean 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。	DisplayObjectContainer
		createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader [静态] 创建新的 NativeWindow 对象，其中包含 HTMLLoader 对象。	HTMLLoader
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	DisplayObject
		getChildAt(index:int):DisplayObject 返回位于指定索引处的子显示对象实例。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 返回具有指定名称的子显示对象。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 返回 DisplayObject 的 child 实例的索引位置。	DisplayObjectContainer
		getHistoryAt(position:uint):HTMLHistoryItem 返回指定位置的历史记录条目。	HTMLLoader
		getObjectsUnderPoint(point:Point):Array 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。	DisplayObject
		globalToLocal(point:Point):Point 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。	DisplayObject
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		historyBack():void 如果可能，在浏览器历史记录中向后浏览。	HTMLLoader
		historyForward():void 如果可能，在浏览器历史记录中向前浏览。	HTMLLoader
		historyGo(steps:int):void 在浏览器历史记录中浏览指定的步骤数。	HTMLLoader
		hitTestObject(obj:DisplayObject):Boolean 计算显示对象，以确定它是否与 obj 显示对象重叠或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。	DisplayObject
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		load(urlRequestToLoad:URLRequest):void 使用 urlRequestToLoad 参数指定的站点中的数据加载 HTMLLoader 对象。	HTMLLoader
		loadString(htmlContent:String):void 使用 HTML 字符串中包含的 HTML 内容加载 HTMLLoader 对象。	HTMLLoader
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	DisplayObject
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		reload():void 从当前位置重新加载页面。	HTMLLoader
		removeChild(child:DisplayObject):DisplayObject 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setChildIndex(child:DisplayObject, index:int):void 更改现有子项在显示对象容器中的位置。	DisplayObjectContainer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 允许用户拖动指定的 Sprite。	Sprite
		stopDrag():void 结束 startDrag() 方法。	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。	DisplayObjectContainer
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。	EventDispatcher
added	将显示对象添加到显示列表中时调度。	DisplayObject
addedToStage	在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。	DisplayObject
click	用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。	InteractiveObject
complete	指出 loadString 或 load 方法上次请求的加载操作已完成。	HTMLLoader
contextMenu	当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。	InteractiveObject
deactivate	Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时调度。	EventDispatcher
doubleClick	如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。	InteractiveObject
enterFrame	播放头进入新帧时调度。	DisplayObject
focusIn	显示对象获得焦点后调度。	InteractiveObject
focusOut	显示对象失去焦点后调度。	InteractiveObject
htmlBoundsChange	指出 HTMLLoader 对象的 contentWidth 和/或 contentHeight 属性已发生更改。	HTMLLoader
htmlDOMInitialize	指出已创建 HTML DOM 以响应加载操作。	HTMLLoader
htmlRender	指出 HTMLLoader 对象中的内容呈现完全处于最新状态。	HTMLLoader
keyDown	用户按下某个键时调度。	InteractiveObject
keyFocusChange	用户尝试使用键盘导航更改焦点时调度。	InteractiveObject
keyUp	用户释放某个键时调度。	InteractiveObject
locationChange	指出更改了 HTMLLoader 对象的 location 属性。	HTMLLoader
middleClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。	InteractiveObject
middleMouseDown	当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。	InteractiveObject
middleMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
mouseFocusChange	用户尝试使用指针设备更改焦点时调度。	InteractiveObject
mouseMove	用户移动 InteractiveObject 上的指针设备时调度。	InteractiveObject
mouseOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
mouseOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
mouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseWheel	当鼠标滚轮滚动到 InteractiveObject 实例上时调度。	InteractiveObject
nativeDragComplete	当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。	InteractiveObject
nativeDragDrop	在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。	InteractiveObject
nativeDragEnter	当拖动动作进入其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragExit	当拖动动作离开其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragOver	当拖动动作保持在其边界内时，由 InteractiveObject 持续调度。	InteractiveObject
nativeDragStart	在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
nativeDragUpdate	在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
removed	将要从显示列表中删除显示对象时调度。	DisplayObject
removedFromStage	在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。	DisplayObject
render	将要更新和呈现显示列表时调度。	DisplayObject
rightClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。	InteractiveObject
rightMouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
rightMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
rollOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
rollOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
scroll	指出 scrollH 或 scrollV 属性已被 HTMLLoader 对象更改。	HTMLLoader
tabChildrenChange	对象的 tabChildren 标志值发生更改时调度。	InteractiveObject
tabEnabledChange	对象的 tabEnabled 标志发生更改时调度。	InteractiveObject
tabIndexChange	对象的 tabIndex 属性值发生更改时调度。	InteractiveObject
uncaughtScriptException	指出在 HTMLLoader 对象中发生了未捕获的 JavaScript 异常。	HTMLLoader

属性详细信息

authenticate

属性

authenticate:Boolean [读写]

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

默认值为 initialized from URLRequestDefaults.authenticate

另请参见

URLRequest.authenticate
URLRequestDefaults.authenticate

cacheResponse

属性

cacheResponse:Boolean [读写]

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

默认值为 initialized from URLRequestDefaults.cacheResponse

另请参见

URLRequestDefaults.cacheResponse

contentHeight

属性

contentHeight:Number [只读 (read-only)]

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

contentWidth

属性

contentWidth:Number [只读 (read-only)]

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

hasFocusableContent

属性

hasFocusableContent:Boolean [只读 (read-only)]

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

height

属性

height:Number [读写]

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

historyLength

属性

historyLength:uint [只读 (read-only)]

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

另请参见

historyPosition

属性

historyPosition:uint [读写]

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

另请参见

htmlHost

属性

htmlHost:HTMLHost [读写]

用于处理某些用户界面元素更改的 HTMLHost 对象，如 HTMLLoader 对象的 window.document.title 属性。此属性仅适用于使用 HTMLLoader 类的 SWF 内容；它在 JavaScript 代码中不起作用。若要覆盖 HTMLLoader 对象的默认行为，请创建 HTMLHost 类的子类，并覆盖其成员函数以处理 HTML 内容中的各种用户界面更改。

另请参见

loaded

属性

loaded:Boolean [只读 (read-only)]

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

location

属性

location:String [只读 (read-only)]

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

manageCookies

属性

manageCookies:Boolean [读写]

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

默认值为 initialized from URLRequestDefaults.manageCookies

另请参见

URLRequest.manageCookies
URLRequestDefaults.manageCookies

navigateInSystemBrowser

属性

navigateInSystemBrowser:Boolean [读写]

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

默认值为 false

paintsDefaultBackground

属性

paintsDefaultBackground:Boolean [读写]

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

pdfCapability

属性

pdfCapability:int [只读 (read-only)]

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

PDFCapability 常数	意义
`STATUS_OK`	已检测到足够高的 Acrobat 或 Adobe Reader 版本（8.1 或更高版本），可以在 HTMLLoader 对象中加载 PDF 内容。注意：在 Windows 中，如果用户系统上当前正在运行 Acrobat 或 Adobe Reader 7.x 或更高版本，则即使安装了支持加载在 HTMLLoader 对象中已加载的 PDF 的更高版本，也会使用正在运行的那个版本。在这种情况下，如果 `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`	已检测到足够高的 Acrobat 或 Adobe Reader 版本（8.1 或更高版本），但为处理 PDF 内容而设置的版本比 8.1 版旧。HTMLLoader 对象无法显示 PDF 内容。

另请参见

runtimeApplicationDomain

属性

runtimeApplicationDomain:ApplicationDomain [读写]

用于 HTML 页的 JavaScript 中的 window.runtime 对象的应用程序域。此属性仅适用于使用 HTMLLoader 类的 SWF 内容；它在 JavaScript 代码中不起作用。

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

引发

SecurityError — 如果 ApplicationDomain 对象不是来自调用方的安全域。

另请参见

scrollH

属性

scrollH:Number [读写]

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

scrollV

属性

scrollV:Number [读写]

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

textEncodingFallback

属性

textEncodingFallback:String [读写]

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

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

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

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

另请参见

textEncodingOverride

属性

textEncodingOverride:String [读写]

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 可恢复默认行为。

另请参见

useCache

属性

useCache:Boolean [读写]

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

默认值为 initialized from URLRequestDefaults.useCache

另请参见

URLRequest.useCache
URLRequestDefaults.useCache

userAgent

属性

userAgent:String [读写]

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

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

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

如果既未为 HTMLLoader 的 userAgent 属性设置值，也未为 URLRequestDefaults.userAgent 设置值，则会使用默认值作为用户代理字符串。此默认值随着运行时操作系统（如 Mac OS 或 Windows）、运行时语言和运行时版本而变化，如下面两个示例所示：

"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
"Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"

另请参见

URLRequest.userAgent
URLRequestDefaults.userAgent

width

属性

width:Number [读写]

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

window

属性

window:Object [只读 (read-only)]

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

构造函数详细信息

HTMLLoader

()

构造函数

function HTMLLoader()

创建 HTMLLoader 对象。

方法详细信息

cancelLoad

()

方法

function cancelLoad():void

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

createRootWindow

()

方法

  function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader

创建新的 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 — 位于新 NativeWindow 对象的舞台上的新 HTMLLoader 对象。

getHistoryAt

()

方法

function getHistoryAt(position:uint):HTMLHistoryItem

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

参数

position:uint — 历史记录列表中的位置。

HTMLHistoryItem — 位于指定位置的历史记录条目的 URLRequest 对象。

另请参见

historyBack

()

方法

function historyBack():void

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

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

此函数不引发错误。

另请参见

historyForward

()

方法

function historyForward():void

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

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

此函数不引发错误。

另请参见

historyGo

()

方法

function historyGo(steps:int):void

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

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

此函数不引发错误。

参数

steps:int — 历史记录列表中要向前移动（正数）或向后移动（负数）的步骤数。

另请参见

load

()

方法

function load(urlRequestToLoad:URLRequest):void

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

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

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

参数

urlRequestToLoad:URLRequest — 包含有关要加载的 URL 的信息的 URLRequest 对象。除了要加载的 URL 以外，URLRequest 对象还包含定义 HTTP 式提交方法（GET 或 POST）的属性、要与请求一起传输的任何数据和请求标头。

另请参见

URLRequest

loadString

()

方法

function loadString(htmlContent:String):void

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

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

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

通过 loadString() 方法加载的内容将会放在应用程序安全沙箱中。

参数

htmlContent:String — 包含要加载到 HTMLLoader 对象中的 HTML 内容的字符串。

reload

()

方法

function reload():void

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

事件详细信息

complete

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.COMPLETE

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

Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已完成加载的网络对象。

另请参见

htmlBoundsChange

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.HTML_BOUNDS_CHANGE

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

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

Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	HTMLLoader 对象。
`target`	HTMLLoader 对象。

另请参见

htmlDOMInitialize

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.HTML_DOM_INITIALIZE

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

Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	HTMLLoader 对象。
`target`	HTMLLoader 对象。

另请参见

htmlRender

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.HTML_RENDER

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

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

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

Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	HTMLLoader 对象。
`target`	HTMLLoader 对象。

locationChange

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.LOCATION_CHANGE

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

Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	HTMLLoader 对象。
`target`	HTMLLoader 对象。

另请参见

scroll

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.SCROLL

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

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

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

Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已滚动的 TextField 对象。`target` 属性不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

uncaughtScriptException

事件

事件对象类型: flash.events.HTMLUncaughtScriptExceptionEvent
属性 HTMLUncaughtScriptExceptionEvent.type = flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION

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

HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION 常量定义 uncaughtScriptException 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`exceptionValue`	计算产生未捕获的异常的 `throw` 语句中的表达式的结果。
`stackTrace`	表示在执行产生未捕获的异常的 `throw` 语句时的堆栈跟踪的对象数组。
`target`	HTMLLoader 对象。

另请参见

window.runtime 属性	window.runtime.flash.html.HTMLLoader

继承	HTMLLoader Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

针对 HTML 开发人员的 Adobe AIR 语言参考	索引 \| 框架无框架
HTMLLoader