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