11.1 Help文件的建立
Help文件是Micosoft Windows3.0以上的版本提供的超文本幫助文件。利用這種超文本,用戶可非常方便地使用幫助文件系統。幫助文件是以主題為主線進行編寫的,一個主題可以跳轉至相關的主題,也可按關鍵字進行主題查詢。幫助文件與軟件開發工具相結合,可實現應用程序的'上下文敏感',而且幫助系統自動裝入。“上下文敏感”是指根據程序當前執行代碼來顯示Help文件的相應部分。
Windows提供的很多應用程序都有幫助系統,讀者可以從這些系統中了解應用程序的許多信息。
11.1.1 建立Help文件所需的工具和文件
程序員可為自己的應用程序建立幫助文件系統。但建立最基本的幫助系統, 必須有以下文件
1. WinHelp 應用程序 ( WinHelp.exe) 。運行幫助系統實際上是運行用幫助源文件的
WindHelp程序。幫助文件只有通過WinHelp文件才能運行。
2. 能創建主題的字處理器。這種處理器能以RTF格式保存文件, 能創建$,#,K,+腳標。RTF(Rich Text Format)格式是一個能記錄各種文本特征的文件格式。這些特征包括字體大小、線型風格等。Microsoft Word 6.0處理器能滿足以上要求。
3. 一個能以ASCII格式保存文件的字處理器或編輯器,這是為了創建Help工程文件(.HPJ文件)。
4. 幫助文件編譯器(HCP.EXE或HC31.EXE),兩種編譯器均能編譯在Windows3.1 環境中使用的幫助文件,但不能編譯Windows3.0環境下的幫助文件。HCP.EXE是保護模式的編譯器,能更好地使用內存空間。要在Windows的Dos窗口中使用HCP.EXE編譯器。
5. 幫助編譯器所需的錯誤信息源文件(HCP.ERR或HC31.ERR)。如果幫助文件在編譯過程中出現錯誤,WinHelp運行時將提示有關的錯誤信息,而這些信息保存在HCP.ERR或HC31.ERR文件中。
以下工具能實現幫助系統的高級特征:
1. 熱點(Hotspot)編輯器(SHED.EXE);
熱點編輯器能創建分段超圖像文件(.SHG)。這種文件包括一些分成多個熱點的圖像,當用戶單擊圖像,將彈出一個窗口或跳轉至另一主題。
2. 多分辨率位圖編譯器(MRBE.EXE);
這種編譯器能將具備多種分辨率的位圖結合到一個文件中,以供WinHelp 使用。WinHelp檢查顯示器的分辨率, 然後以相應的分辨率加以顯示。
3. 圖像編輯器,它能以位圖形式保存圖像文件。 使用圖像編輯器創建說明和自定義按鈕。
4. 繪圖軟件。用以創建除了位圖之外的元文件(WMF);
程序員可以直接把圖像插入文本中,也可以用Windows剪貼板把圖像粘貼至文本中。
11.1.2 Help文件的創建
下面介紹最簡單、最直接的創建Help文件的方法,假設在Word中創建主題。
創建Help文件分以下4個步驟:
1. 建立組成幫助文件的主題,並以RTF格式保存;
2. 建立內容主題(Content Topic),並以RTF格式保存;
3. 建立幫助工程文件(.HPJ)以文本格式保存;
4. 將工程文件編譯成幫助源文件(.HLP)。
11.1.2.1 建立主題
一個簡單的幫助主題包括主題題目(Title),主題文本(Text),腳標,主題內容,全局查詢、打印。主題最好是帶有題目,題目寫在主題的第一行。用不同的字體大小、顏色以示區別
寫完題目後,可輸入主題的文本。輸入時不用擔心每行的寬度。 編譯好的幫助文件會根據窗口大小自動確定行寬。在主題的最後插入一個分頁符,WinHelp把每頁視為一個單獨主題。
書寫主題文本時應注意盡可能地把文本寫成小段落列表,這樣能方便閱讀; 同時要控制主題長度,這樣用戶不需要使用滾動條來閱讀文本。
在主題中應加入一些腳標, WinHelp 使用這些腳標辨識主題並提供一些導向控制 (Novigation Control),四種典型腳標如表11.1所示。
表11.1 腳標以及用途
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
符號 適用於 用 途
──────────────────────────────────
# 內容字符串 唯一辨識主題
$ 標題 在搜詢對話框和搜詢歷史列表框中顯示主題
K 關鍵字(段) 出在搜詢對話框中
+ 浏覽順序 用戶使用時的浏覽順序
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
以下分別介紹四種腳標的插入方法:
1. 插入#腳標。把光標移至主題的最前端插入#腳標。這時主題文本下端也會出現#,在此後鍵入內容字符串。WinHelp使用內容字符串作為唯一的辨識主題。用戶永遠也看不見這些字符串,但設計人員用它們定義跳轉主題。
2. 插入$腳標,把光標移至#腳標後,插入$腳標。在文本下端的$腳標處,輸入主題的標題,該標題與第一行出現的標題一致,標題將會出現在搜詢對話框和搜詢歷史對話框中
3. 插入K腳標。在主題第一行的腳標之後插入K腳標,在主題文本中的K 腳標後鍵入字段,這些字段將出現在搜詢列表框中,見11.3圖。