htc参考

在微软(R)Internet Explorer 5中介绍，HTML组件(HTCs)提供一种机制来使用脚本作为动态HTML(DHTML)行为实现组件功能。以.htc扩展名保存，一份HTC是一份包含脚本和一组用于定义组件的HTC特殊元素的HTML文件。此部分包含相关元素和它们支持的成员。

对象
document
在给定的浏览器窗口中表现HTML文档。
element
返回一份主文档中连接行为的标签的参考。
PUBLIC:ATTACH
绑定一个函数到一个事件上，因此每次事件发生在特殊对象上时函数会被调用。
PUBLIC:COMPONENT
以HTC指明文件的内容。
PUBLIC:DEFAULTS
设定一份HTC的默认属性。
PUBLIC:EVENT
定义一个HTC的事件，使之暴露于包含该HTC的文档。
PUBLIC:METHOD
定义一个HTC的方法，使之暴露于包含该HTC的文档。
PUBLIC:PROPERTY
定义一个HTC的属性，使之暴露于包含该HTC的文档。

方法
createEventObject
创建一个事件对象，当需要传递事件附加信息给PUBLIC:EVENT元素的fire方法时使用。

事件
oncontentready
连接了行为的元素的内容完全被解析时发生。
oncontentsave
连接了一份元素行为的一个元素的内容被保存或复制前发生。
ondetach
从一个元素解除一份行为的连接前发生。
ondocumentready
当包含行为的文档完全被解析时发生。

[教程]HTC参考----element对象

element对象
--------------------------------------------------------------------------------------
返回一份主文档中连接行为的标签的参考。

成员表格
下面的表格列举了element对象暴露出的成员。
方法
createEventObject
创建一个事件对象，当需要传递事件附加信息给PUBLIC:EVENT元素的fire方法时使用。

备注
连接了行为的元素的所有属性、方法和事件，均可以由HTML组件(HTC)通过此对象访问。element对象是属性、方法或HTC中指定的事件名称的默认对象。因此，它们可以直接的被指定，而无须使用element关键字。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/objects/element.htm
--------------------------------------------------------------------------------------

[教程]HTC参考----PUBLIC:ATTACH元素

PUBLIC:ATTACH元素
--------------------------------------------------------------------------------------
绑定一个函数到一个事件上，因此每次事件发生在特殊对象上时函数会被调用。

格式
<PUBLIC:ATTACH
EVENT = "sEvent"
FOR = "sObject"
ID = "sID"
ONEVENT = "sEventHandler"
/>

属性
EVENT
必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
FOR
可选。指定为下面值中一个的字符串，用来识别事件源。
document
引用document对象。
element
默认值。引用行为连接的元素。
window
引用window对象。
ID
可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
ONEVENT
必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

元素信息
父级元素
PUBLIC:COMPONENT
子级元素
无
最小运行环境
Internet Explorer 5
最小操作系统
Windows 95, Windows NT 4.0

备注
PUBLIC:ATTACH元素是attachEvent方法的一份声明。
当指定的事件发生在连接了行为的元素时，首先调用的是元素的事件处理部分，且在行为的事件处理前。如果多个行为被连接到一个元素，同时多个事件处理部分定义在同一元素的同一事件上，函数在元素事件处理部分调用后会随机地被调用。
当为ONEVENT提供一个值时，避免赋予事件处理部分函数一个已经存在的DHTML事件的名称。使用一个已经存在的DHTML事件的名称可能会递归错误。
事件的名称对所有脚本语言都是大小写敏感的。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/elements/attach.htm
--------------------------------------------------------------------------------------
[教程]HTC参考----PUBLIC:COMPONENT元素

PUBLIC:COMPONENT元素
--------------------------------------------------------------------------------------
以HTC指明文件的内容。

微软Internet Explorer 6中的新内容
literalContent属性作为一个新的可能值支持嵌套，创建一份嵌套的文字内容元素行为。

格式
<PUBLIC:COMPONENT
ID = "sID"
lightWeight = "bLight"
literalContent = "sLiteral"
NAME = "sName"
supportsEditMode = "bEditable"
tagName = "sTagName"
URN = "sURN"
>
<!-- 子级元素 -->
</PUBLIC:COMPONENT>

属性
ID
可选。组件内PUBLIC:COMPONENT元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
lightWeight
可选。指定HTC文件是否包含标签的字符串。如果HTC文件不包含标签，这个属性应当设置为true来改进表现效果。这个属性对任何HTC文件均有效。
true
HTC文件不包含标签，因而无需每次都解析并表现自定义标签。这些标签由HTC文件定义，在主文档中使用。
false
默认值。HTC包含必需解析并表现的自定义标签。这些标签由HTC文件定义，在主文档中使用。
literalContent
可选。指定自定义标签包含的内容是被解析并表现，还是作为数据岛处理的字符串。这个属性仅在HTC文件定义一个元素行为时有效，此时需要使用tagName属性。更多信息请查阅备注。
false
默认值。由tagName属性定义的标签内的文本和标签并作为数据岛处理，而是解析并表现。
nested
Internet Explorer 6及后继版本。Content within the first opening and last closing of the tag defined by the tagName attribute is treated as a data island and is not parsed or rendered.更多信息请查阅使用literalContent属性。
true
Content within the first opening and last closing of the tag defined by the tagName attribute is treated as a data island and is not parsed or rendered.
NAME
可选。指定主文档中提交的行为的名称的字符串。
supportEditMode
可选。指定HTC文件内容是否可编辑的字符串。这个属性仅在HTC文件定义一个元素行为时有效。
true
HTC文件包含的标签可编辑。
false
默认值。HTC文件包含的标签不可编辑。你能够通过对HTC文件中每个元素设定isContentEditable属性为VARIANT_TRUE来重载此属性值。
tagName
可选。指定自定义标签名称的字符串，此标签由HTC文件定义并导入到主文档中。这个属性仅在HTC文件定义一个元素行为时有效。更多信息请查阅备注。
URN
可选。字符串，以统一资源名称(URN)格式，从而唯一识别此组件。因而在多个行为发生在同一名称的事件时可以唯一的识别。当事件发生，event对象的srcUrn属性被设定为发生在事件上行为的URN。

元素信息
子级元素
至多出现一次
PUBLIC:DEFAULTS
一或多次出现
PUBLIC:ATTACH，PUBLIC:EVENT，PUBLIC:METHOD，PUBLIC:PROPERTY
最小运行环境
Internet Explorer 5
最小操作系统
Windows 95, Windows NT 4.0

备注
PUBLIC:COMPONENT元素可以定义两种截然不同类型的行为。一种是连接行为，使用behavior层叠样式表(CSS)属性来修改一个已经存在的元素的行为。第二种类型，在Internet Explorer 5.5 中介绍，被称作一个元素行为。一个元素行为用来定义如标准的HTML标签一样在网页中使用的自定义标签。
一个元素行为意味着网页中一个自定义标签的创建和使用。因此，当HTC文件定义一个元素行为时有必要定义PUBLIC:COMPONENT元素的tagName属性。如先前指出的，此元素的部分属性为元素行为特别设计。更多信息清查询元素行为。
当多个行为连接到同一元素时，NAME属性特别有用。因为它允许你调用包含文档中需要的行为的属性和方法。如果在一份文档中多个行为被连接到一个<SPAN ID="mySpan">元素，你可以使用下面的格式来设定命名为behaviorA白痴的行为的delay属性。
mySpan.behaviorA白痴.delay = 1000;
--------------------------------------------------------------------------------------
[教程]HTC参考----PUBLIC:DEFAULTS元素

PUBLIC:DEFAULTS元素
--------------------------------------------------------------------------------------
设定一份HTC的默认属性。

格式
<PUBLIC:DEFAULTS
canHaveHTML = "bCanHaveHTML"
contentEditable = "bEditable"
style = "sStyle"
tabStop = "bIsTabStop"
viewInheritStyle = "bInheritsStyle"
viewLinkContent = "bViewLinkContent"
viewMasterTab = "bViewMasterTab"
/>

属性
canHaveHTML
可选。指定为下列之中一个的布尔值。
false
HTC文件定义的标签的内容不能包含HTML标签。
true
HTC文件定义的标签的内容可以包含HTML标签。
contentEditable
可选。指定为下列之中一个的布尔值。
inherit
默认值。对象从它的父级继承内容被用户编辑的能力。
false
HTC文件定义的标签的内容不能编辑。
true
HTC文件定义的标签的内容可以编辑。
style
可选。指定HTC文件定义的标签的样式字符串。
tabStop
可选。指定为下列之中一个的布尔值。
false
默认值。HTC文件定义的标签不可被TAB选择激活。
true
HTC文件定义的标签可以被TAB选择激活。
viewInheritStyle
可选。指定为下列之中一个的布尔值。
false
Viewlink不从主HTML文件中继承样式。
true
默认值。Viewlink从主HTML文件中继承样式。
viewLinkContent
可选。指定为下列之中一个的布尔值。
false
默认值。HTC文件的文档中标签不作为viewlink使用。
true
HTC文件的文档中标签作为viewlink使用。
viewMasterTab
可选。指定为下列之中一个的布尔值。
false
viewlink的主元素不包含在主文档的TAB序列中。
true
默认值。viewlink的主元素包含在主文档的TAB序列中。

元素信息
父级元素
PUBLIC:COMPONENT
子级元素
无
最小运行环境
Internet Explorer 5
最小操作系统
Windows 95, Windows NT 4.0

备注
在HTC文件中使用viewLinkContent属性的更多信息，查阅Viewlink介绍文章中创建一个Viewlink部分。
--------------------------------------------------------------------------------------

[教程]HTC参考----PUBLIC:EVENT元素

PUBLIC:EVENT元素
--------------------------------------------------------------------------------------
定义一个HTC的事件，使之暴露于包含该HTC的文档。

格式
<PUBLIC:EVENT
ID = "sEventID"
NAME = "sName"
/>

属性
ID
可选。组件内PUBLIC:EVENT元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
NAME
必选。指定主文档中提交的事件的名称的字符串。

方法
eventID.fire([oEvent])
包含的文档发生事件。
这个方法有下面的参数：
oEvent
指定event对象包含的附加信息的对象。

元素信息
父级元素
PUBLIC:COMPONENT
子级元素
无
最小运行环境
Internet Explorer 5
最小操作系统
Windows 95, Windows NT 4.0

备注
通过指定一个NAME属性，类似于一个已经为元素定义的标准事件，一个行为可以重载元素默认的行为。
行为定义的事件不起泡。它们只发生在连接了行为的元素上。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/elements/event.htm
--------------------------------------------------------------------------------------

[教程]HTC参考----PUBLIC:METHOD元素

PUBLIC:METHOD元素
--------------------------------------------------------------------------------------
定义一个HTC的方法，使之暴露于包含该HTC的文档。

格式
<PUBLIC:METHOD
ID = "sID"
INTERNALNAME = "sInternalName"
NAME = "sName"
/>

属性
ID
可选。组件内PUBLIC:METHOD元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
INTERNALNAME
可选。包含文档中指定方法提交的名称的字符串。默认情况下，NAME也指定提交到组件内的方法，除非INTERNALNAME属性被指定。

元素信息
父级元素
PUBLIC:COMPONENT
子级元素
无
最小运行环境
Internet Explorer 5
最小操作系统
Windows 95, Windows NT 4.0

备注
当指定NAME属性与一个已经为该元素定义的标准方法的名称相同时，一个行为可以重载元素的默认行为。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/elements/method.htm
--------------------------------------------------------------------------------------

[教程]HTC参考----PUBLIC:PROPERTY元素

PUBLIC:PROPERTY元素
--------------------------------------------------------------------------------------
定义一个HTC的属性，使之暴露于包含该HTC的文档。

格式
<PUBLIC:PROPERTY
GET = "sGetFunction"
ID = "sPropertyID"
INTERNALNAME = "sInternalName"
NAME = "sName"
PERSIST = "bPersist"
PUT = "sPutFunction"
value = "vvalue"
/>

属性
GET
可选。指定属性值被获得时调用的函数的字符串。一个只指定了GET属性而没有指定PUT属性的PUBLIC:PROPERTY元素是一个只读属性。
ID
可选。组件内PUBLIC:PROPERTY元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
INTERNALNAME
可选。包含文档中指定方法提交的名称的字符串。这个内部的名称必须在组件内任意参考前广泛的关联；否则，一个脚本错误出现，指出名称未定义。如果没有内部的名称被指定，默认情况下使用NAME属性。
NAME
必选。指定暴露给包含文档的属性的名称的字符串。默认情况下，NAME的指定也用于组件内属性的提交，除非INTERNALNAME属性被指定。
PERSIST
可选。指定是否坚持属性作为叶面的部分的布尔值。
PUT
可选。指定属性值被设定时调用的函数的字符串。一个指定了GET和PUT属性的PUBLIC:PROPERTY元素是一个读写属性。一个PUT函数被指定，而指定GET函数指定失败，会导致该属性只可写，一般来说这是不希望出现的。
value
可选。指定属性默认值的变量。

方法
propertyID.fireChange()
通报包含文档属性值在元素上发生onpropertychange事件时被改变。如果属性没有PUT属性被指定，在包含文档中属性被设定时onpropertychange会自动发生。

元素信息
父级元素
PUBLIC:COMPONENT
子级元素
无
最小运行环境
Internet Explorer 5
最小操作系统
Windows 95, Windows NT 4.0

备注
当指定NAME属性与一个已经为该元素定义的标准方法的名称相同时，一个行为可以重载元素的默认行为。
如果PUT或GET属性被指定，INTERNALNAME属性被忽略。通过在PUT和GET属性中指定的函数来设定与/或获得属性值，优先级高于通过INTERNALNAME设定和/或获得属性值。
PUT属性指定的函数必须注意包含文档中的元素使用PUBLIC:PROPERTY元素的fireChange方法改变属性值的情况。调用这个方法导致onpropertychange事件发生在包含文档的相应元素，同时event对象的propertyName设定为属性的名称。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/elements/property.htm
--------------------------------------------------------------------------------------
[教程]HTC参考----createEventObject方法

createEventObject方法
--------------------------------------------------------------------------------------
创建一个事件对象，当需要传递事件附加信息给PUBLIC:EVENT元素的fire方法时使用。

格式
oEvent = element.createEventObject()

返回值
返回一个event对象。

备注
相同的event对象无法在多次调用fire方法时被重复使用。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/methods/createeventobject.htm
--------------------------------------------------------------------------------------
[教程]HTC参考----oncontentready事件

oncontentready事件
--------------------------------------------------------------------------------------
连接了行为的元素的内容完全被解析时发生。

格式
<PUBLIC:ATTACH
EVENT = oncontentready
ONEVENT = sEventHandler
FOR = element
ID = sID
/>

属性
EVENT
必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
FOR
可选。指定为下面值中一个的字符串，用来识别事件源。
document
引用document对象。
element
默认值。引用行为连接的元素。
window
引用window对象。
ID
可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
ONEVENT
必选。事件处理函数的直接声明或一份行内脚本的指定字符串。

备注
在事件发生前，该元素的innerHTML属性可能无法返回正确的值。
当事件发生且PUBLIC:COMPONENT元素的literalContent属性为真时，元素行为的文字内容已被存储在innerHTML属性中。这个事件指出元素行为可以访问innerHTML属性。
因为这个事件仅对HTC组件有效，绑定oncontentready事件的唯一方法是使用PUBLIC:ATTACH元素。attachEvent因为只对标准DHTML事件工作而无法绑定此事件。当一份HTC文件作为Viewlink实现时，oncontentready事件，或其他任何HTC专用事件，在文档片断中无法连接到元素上。
关于在一份HTC文件和其主文档初始化过程中事件发生的总体看法，请参阅组件初始化。

范例
ms-help://MS.MSDNQTR.2003APR.1033/Behavior/workshop/components/htc/reference/events/oncontentready.htm
--------------------------------------------------------------------------------------
[教程]HTC参考----oncontentsave事件

oncontentsave事件
--------------------------------------------------------------------------------------
连接了一份元素行为的一个元素的内容被保存或复制前发生。

格式
<PUBLIC:ATTACH
EVENT = oncontentsave
ONEVENT = sEventHandler
FOR = element
ID = sID
/>

属性
EVENT
必选。指定一个动态HTML(DHTML)事件、或任何在HTC参考中列举出的由HTML组件(HTC)指定事件的字符串。
FOR
可选。指定为下面值中一个的字符串，用来识别事件源。
document
引用document对象。
element
默认值。引用行为连接的元素。
window
引用window对象。
ID
可选。组件内PUBLIC:ATTACH元素的唯一识别字符串。这个属性类似于DHTML中的ID属性。
ONEVENT
必选。事件处理函数的直接声明或一份行内脚本的指定字符串。