HTML Help Workshop制作chm帮助文件和在应用程序中的调用
最近在使用微軟公司提供的HTML ? Help ? Workshop工具包 制作chm幫助文件,?現在總結如下:
???
一、制作前的HTML文件準備工作 ?
?
由于chm幫助文件是基于HTML文件特征的，所以前期編寫HTML文件的準備工作很重要。 它的每個主題就是一個HTML文件 , 主題文件
?
可以用任何一個HTML編輯器進行編輯，也可用HTML????Help ? Workshop編輯, 也可以通過Word ? 97或Word ? 2000，將Word格式的
?
主題文件轉換成HTML格式。??
?
二、創建項目文件 ?
? 第一步：點擊HTML ? Help ? Workshop菜單欄中的“File/New”命令，這時出現“選擇新建內容”的對話框，選中“Project”。 ?
? 第二步：，按“OK”按鈕后，將“Convert ? WinHelp ? Project”這個選項留空，繼續下一步。??
? 第三步：在彈出的"Destination"界面中,點擊“Browse”按鈕，設置放置項目文件的目錄及項目文件名, 如 test，完成后，繼續下一
?
步。 ?
? 第四步：因為我們已經事先建好了html文件，此時請選擇“HTML ? file”，繼續下一步。 ?
? 第五步：點一下“Add”按鈕并加入已經編輯好的主題文件（也就是設置成首頁面的HTML文件）。點擊“下一步”，最后點擊“完成”按
?
鈕，新的項目即已新增完成。 ?這里也可以不添加, 直接下一步
現在就可以進入HTML ? Help??Workshop工作窗口。在窗口的上方是3個卷標，分別是“Project（項目）”、“Contents（目錄）”、
?
“Index（索引）”。 ?
?
? 在“Project”卷標的左側是7個按鈕，它們的功能名稱自上而下分別是：“Change ? project ? options（改變項目選項）”、
?
“Add/Remove ? topic ? files（添加/刪除主題文件）”、“Add/Modify ? window ? definitions（添加/修改窗口定義）”、“HtmlHelp ?
?
API ? information（HTML幫助API信息）”、“View ? HTML ? source（校驗HTML源文件）”、“Save ? Project ? Contents ? and ?
?
Index ? files（保存項目、目錄和索引文件）”、“Save ? all ? file ? and ? Compile（保存全部文件并編譯）”。
?
??? 第六步：點擊“Project”編輯窗口下方的“Change ? Project?? Options”按鈕后，會彈出一個“Options”對話框。在這個對話框的
?
“General”卷標的“Title”中輸入標題“test 幫助文檔”，編譯后這個標題將出現在chm文件窗口的標題欄中。在“File”卷標中選上
?
“Automatically ? create ? contents ? file（.hhc） ? when ? compiling”。 ?
? chm文件的“Search（搜索）”選項允許用戶在所有主題文件中搜索字、詞或短語，將它們的標題顯示出來，而且用醒目的方式顯示在
?
主題中。在 “Compiler”卷標中選上“Compiler ? full－text ? search ? information”，即可支持全文檢索功能。 ?
?
? 第七步：點擊“Save ? project ? file ? and ? ?
? compile”按鈕，雖然此時已經可以觀看結果了，不過，我們要再多作一項設定讓最后的成品再完整些。
三、創建目錄文件??
??? 第一步：點擊HTML ? Help ? Workshop工作窗口的“Contents”卷標，這時系統彈出一個對話框，提示你“項目”還沒有關聯目錄文
?
件（.hhc），選擇“Create ? a ? new ? contents ? file”，點擊“OK”按鈕后將創建一個新的目錄文件。
?
? 第二步：請指定一個新目錄文件名和存放路徑，點擊“保存”后出現目錄編輯窗口，目錄編輯窗口的左側有11個按鈕。 ?
? 第三步：根據需要插入標題（類似資源管理器中的目錄）或頁面（類似資源管理器中某目錄下的文件），按下“Insert ? a ?
?
heading（插入標題）”或“Insert ? a ? page（插入頁面）”按鈕，都會彈出“Table ? of ? Contents ? Entry”對話框，在“Entry ? title”
?
輸入框中輸入條目的標題，并根據情況選定對應的主題文件，單擊“Entry ? title”下的“Add”按鈕，在彈出的對話框下面的“File ? or ? URL”
?
輸入框中 選擇在幫助文件中單擊該主題時打開的頁面,我們在對話框中選擇一個.htm文件,最后單擊"確定"按鈕.
?
? 第四步：如果在單擊“Insert ? a ? page”按鈕之前所選擇的條目不包含別的條目，也不被別的條目所包含，那么會詢問“Do ? you ?
?
want ? to ? insert ? this ? entry ? at ? the ? beginningof ? the ? table ? of ? contents？”，選擇了“是”會增加起始條目（一級條
?
目），選擇了“否”會增加一個子條目。 ?
? 標題可以分為多級，要按照制作的內容統一考慮。如果覺得不滿意，可以用左側的箭頭進行調整，也可以選定該條目，單擊鼠標右鍵，
?
不但可以調整，還可以插入標題、主題或目錄文件。
四、創建索引文件 ?
? 索引文件（hhk）也是一個HTML文件，它包含若干個關鍵詞，當用戶打開chm文件后，單擊索引標簽并輸入一個關鍵詞后，chm文件
?
將顯示與這個關鍵詞有關的主題的列表，使大家非常方便地找到相關主題。 ?
? 第一步：點擊HTML ? Help ? Workshop工作窗口的“Index”卷標，這時系統彈出一個對話框，提示你“項目”還沒有關聯索引文件
?
（.hhk），選擇“Create ? a ? new ? contents ? file”，點擊“OK”按鈕后將創建一個新的索引文件。 ?
? 第二步：請指定一個新索引文件名和存放路徑，點擊“保存”后出現索引編輯窗口，索引編輯窗口的左側有11個按鈕。
?
? 第三步：單擊“Insert ? a ? keyWord”按鈕，出現“Index ? Entry”對話框，在“General”選項的“KeyWord”輸入框中輸入關鍵詞，
?
再單擊“Add”按鈕添加與該關鍵詞相關聯的主題文件。如果想跳 轉到另一個關鍵詞，在“Index ? Entry”對話框中按“Advance”選項，選中
?
“Target ? is ? Another ? KeyWord”，再單擊“General”選項的“KeyWord”輸入框中輸入關鍵詞，再單擊“Add”按鈕添加與要跳轉的關鍵
?
詞相關聯的主題文件， 單擊“OK”按鈕。最后單擊“確定”按鈕，并按“Save ? file”進行存盤。
五、最后的設置工作 ?
? 第一步：選擇“Project”卷標，點擊“Change ? Project ? Options”按鈕，在“File”卷標的“Content ? file”項目中，點擊“Browse”
?
指定為toc.hhc。在“Index ? file”項目中，點擊“Browse”指定為index.hhc。在"Default? file"中輸入打開幫助文件時的默認界面,我們可
?
以輸入一個.htm文件的路徑??
? 第二步：重新點擊“Save ? project ? file ? and ? compile”按鈕進行存盤編譯。 ?
? 第三步：最后點擊主菜單“View/Compiled ? file”，通過“Browse”指定該chm文件的目錄及文件名即可看到我們的作品了 ?
? 的確也夠簡單的了，只要有完整的HTML源文件，激活Html ? Help ? Workshop創建一個新的項目文件，將第一個html（通常是
?
default.htm或index.html）加進項目，存盤并編譯就大功告成。同樣 的一組HTML文件，放在網站上是一頁一頁的網頁，變成單一的chm
?
后，則可用作軟件輔助說明，而且已經內建了全文檢索功能。 ?
? 上述介紹的只是制作chm幫助文件的基本步驟。但它的功能遠非這些，如：可向HTML文件中插入HTML ? Help ? ActiveX控件、Java
?
腳本、彈出式窗口等等。還可將已有的chm文件解壓縮變回原來的HTML文件。?
?
六.在應用程序中調用CHM幫助文件.
?
在vc 中:
?
??方法一: 使用ShellExcute打開,??? 就跟啟動其他程序一樣的?????
??
? ShellExecute(NULL,"open","test.chm",NULL,NULL,SW_SHOWMAXIMIZED);???
?
?方法二: ?用HTML Help Workshop SDK中的HtmlHelp函數
?
1. 確認已經安裝htmlhelp?? ,? 將HTML ? Help ? Workshop/include/htmlhelp.h 和HTML ? Help ? Workshop/lib/htmlhelp.lib 兩個
?
文件拷貝到vc的項目文件夾中, Add to project 加入htmlhelp.h
?
2. 加入代碼 #include "htmlhelp.h"? #pragma?? comment(lib,"htmlhelp.lib")???
?
HtmlHelp( m_hWnd,"test.chm",HH_DISPLAY_TOPIC,0);??
?
在C#中:
?
將剛才制作的幫助文件拷貝到你的C#程序的Debug目錄下,然后雙擊菜單中的"幫助"按鈕, 添加如下代碼:
Help.ShowHelp(this,@"test.chm");
然后為"幫助"菜單添加個快捷鍵F1,這樣在程序運行時,按F1鍵即可打開幫助文件.?
?
HTML Help Workshop下載：??http://msdn.microsoft.com/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp
參考資料: http://topic.csdn.net/t/20020613/16/801118.html
http://blog.csdn.net/zhangyang0402/archive/2007/05/06/1598512.aspx
http://blog.csdn.net/afxapi/archive/2004/12/23/226654.aspx
總結
以上是生活随笔為你收集整理的HTML Help Workshop制作chm帮助文件和在应用程序中的调用的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： android中给button加图标,A
- 下一篇： raml2html 安装,Raml实践