3. 提供有關屬性和事件的幫助

　　當在窗體中選擇一個部件或在Object Inspector中選擇事件或屬性時，能夠按F1得到有關這一項的幫助。如果創建了相應的Help文件的話，自定義部件的用戶能得到有關你的部件的相應的文檔。

　　因為Delph使用了特殊的Help引擎支持跨多個Help文件處理主題搜索，所以你能提供關于自定義部件的小的Help文件，用戶不需要額外的步驟就能找到你的文檔。你的Help成了Delphi Help系統的一部分。

　　要給用戶提供幫助，要理解下列兩方面:

　　● Delphi怎樣處理HELP請求

　　● 將HELP插入Delphi

　　⑴ Delphi怎樣處理HELP請求

　　Delphi基于關鍵詞查詢HELP請求。就是說，當用戶在窗體設計窗口的已選部件上按F1鍵時，Delpdi將部件的名字轉換成一個關鍵詞，然后調用Windows Help引擎查找那個關鍵詞的幫助主題。關鍵詞是Windows Help系統的標準部分。實際上 ，WinHelp使用Help中的關鍵詞產生Search對話框中的列表。因為用于上下文敏感搜索中的關鍵詞不是實際供用戶讀的，所以要輸入關鍵詞的替代詞。

　　例如，一個查找名為TSomething的部件的詳細信息的用戶可能打開WinHelp的Search對話框并輸入TSomething。但不會使用用于窗體設計窗口的上下文查找的替代形式class-TSomething。因此，這個特殊的關鍵詞Class-TSomething對用戶是不可見的，以免弄亂了搜索列表。

　　⑵ 將Help插入Delphi

　　Delphi提供了創建和插入Windows Help文件的工具，包括Windows Help編譯器HC.EXE。為自定義部件建立Help文件的機制與建立任何Help文件沒什么不同，但需要遵循一些約定以與庫中其它Help兼容。

　　保持兼容性的方法如下：

　　● 建立Help文件

　　● 增加特殊的注腳

　　● 建立關鍵詞文件

　　● 插入Help索引

　　當你為自定義部件建立完Help，有下列幾個文件：

　　● 編譯過的Help(.HLP)文件

　　● Help關鍵詞(.KWF)文件

　　● 一個或多個Help源文件(.RTF)

　　● Help工程文件(.HLJ)

　　編譯過的Help文件和關鍵詞文件應當與庫單元在同一目錄。

　　① 建立Help文件

　　你可以使用任何的工具創建Windows Help文件。Delphi的多文件搜索引擎，可以包含任何數目的Help文件的要素。在編譯的Help文件之外，你應當擁有RTF源文件，這樣才能生成關鍵詞文件。

　　為使自定義部件的Help同庫中其它部件一起工作，要遵循下列約定：

　　● 每個部件有占一頁的幫助

　　部件幫助頁應當給出部件目的的簡單描述，然后列出最終用戶可用的屬性、事件和方法的描述。應用開發者通過在窗體上選擇部件并按F1訪問這一頁。

　　部件幫助頁應當有一個用于關鍵詞搜索的“K”腳注，腳注中包含部件名。例如，TMemo的關鍵詞腳注讀作 "TMemo Component"

　　● 部件增加和修改的每一個屬性，事件和方法應當有一頁幫助

　　屬性、事件或方法的幫助頁應當指出該項用于哪個部件，顯示聲明語法和描述它的使用方法。

　　屬性、事件或方法的幫助頁應當有一個用于關鍵詞搜索的“K”腳注，該腳注中包含該項的名字和種類。例如，屬性Top的關鍵詞腳注為“Top property”。

　　Help文件的每一頁也需要用于多文件索引搜索的特殊腳注。

　　② 增加特殊腳注

　　Delphi需要特殊的搜索關鍵詞以區別用于部件的幫助頁和其它項目。你應當為每一項提供標準的關鍵詞搜索項。但你也需要用于Delphi的特殊腳注。

　　要為來自Object Inspector窗口或代碼編輯器F1的搜索增加關鍵詞，就得為Help文件幫助頁增加 "B"腳注。

　　“B”腳注與用于標準WinHelp關鍵詞搜索的“K”腳注很相象，但它們只用于Delphi搜索引擎。下表列出怎樣為每種部件幫助頁建立“B”腳注：

　　表19.7 部件幫助頁搜索注腳

　　━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

　　幫助頁類型 "B"腳注內容 示 例

　　──────────────────────────────────

　　主部件頁 'class_'+部件類型名 class_TMemd

　　一般屬性或事件頁 'prop_'+屬性名 prop_WordWrap

　　'event_'+事件名 event_OnChange

　　部件特有的屬性 'prop_'+部件類型名 prop_TMemoWordWrap

　　或事件頁 +屬性名

　　'event_'+部件類型名 event_TMemoOnChange

　　+事件名

　　━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

　　區別一般幫助頁和部件特有的幫助頁是很重要的。一般幫助頁應用于所有部件上的特定屬性和事件。例如Left屬性是所有部件中的標識。因此，它用字符串Prop-Left進行搜索。而Borde-style依賴于所屬的部件，因此，BorderStyle屬性擁有自己的幫助頁。例如，TEdit有BorderStyle屬性的幫助頁，搜索字符串為Prop_TEditBorderStyle。

　　③ 建立關鍵詞文件

　　建立和編譯了Help文件，并且增加了腳注之后，還要生成獨立的關鍵詞文件，這樣Delphi才能將它們插入主題搜索的索引。

　　從Help資源文件RTF創建關鍵詞文件的方法如下：

　　● 在DOS提示行下，進入包含RTF文件的目錄

　　● 運行關鍵詞文件產生程序——KWGEN.EXE，后跟Help工程文件，如KWGEN SPECIAL.HPJ。當KWGEN運行完畢后，就有了與Help工程文件相同的關鍵詞文件，但以.KWF為擴展名

　　● 將關鍵詞文件放在編譯完的庫單元和Help文件相同的目錄

　　當你在Component Palette上安裝部件時，希望關鍵詞插入Delphi Help系統的搜索索引。

　　④ 插入Help索引

　　以自定義部件建立關鍵詞文件后，要將關鍵詞插入Delphi的Help索引。

　　將關鍵詞文件插入Detphi Help索引的方法如下：

　　● 將關鍵詞文件放在與編譯完的庫單元和Heph文件相同的目錄中

　　● 運行HELPINST程序

　　HELPINST運行完后，Delphi的Help索引文件(.HDX)包含自定義部件幫助頁的關鍵詞。