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
子級元素
無