HTC基础篇（二）－－对象

 

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
     子级元素：　　无

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

 

 

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

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

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

元素信息
     父级元素
     PUBLIC:COMPONENT
     子级元素
     无
     最小运行环境
  备注
     当指定NAME属性与一个已经为该元素定义的标准方法的名称相同时，一个行为可以重载元素的默认行为。

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

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

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

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

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

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
     子级元素
     无