软件热点敏感帮助的实现

天云上人

　　很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助，网上搜索的资料也不多，可能是太简单了吧，呵呵！今天整理了一下，详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。

) h, ?3 L7 h7 z1 K: x  @一、软件中对CHM帮助文档的调用方法

$ @1 G7 Q5 P( R　　VC中调用CHM帮助必须用API函数HtmlHelp()，此函数在LIB库函数内，为方便调用，我把它整体打包了，您要做的就是把它放到VC工程所在的目录，然后包含CHMHelp.h头文件即可。
系统包含文件如下：
9 M7 @2 d( D% o+ M

1. #include "CHMHelp.h"
   
2. 
   ) B  ]4 l; @, ]- E9 S3 e) ]
3. BOOL CDataDlg::OnInitDialog()
   + u  t; B( H8 _
4. {
   / Y- [- q4 w% h0 A1 ~; W' o9 ^) q' v
5.         CDialog::OnInitDialog();
   ; r2 y+ n! T4 X: t
6.         SetWindowContextHelpId(IDH_WJH_0300702025);
   
7.         return TRUE;
   
8. }

复制代码

! A8 S! }4 W/ t8 w2 C! V　　上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID，设置了ID后在需要显示帮助的过程中（一般是用户按F1）增加如下代码：

1. BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo)
   0 \5 h- D! W* j) J& j
2. {
   
3.         HWND hWnd;
   
4.         if(pHelpInfo->dwContextId > 0)
   
5.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
   # j6 ?1 K; m+ o5 w% k! p
6.                                         theApp.m_szHelpFile,
   8 |; Q8 k) {7 ?" B) ?
7.                                         HH_HELP_CONTEXT,
   : V5 k$ `- X/ J
8.                                         pHelpInfo->dwContextId);
   , f, a0 v0 Q7 ?0 H/ w) u& D
9.         else
   & T$ @3 P9 D' G" `5 _3 v3 |. ]1 W* j
10.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
    " O+ z. G! X$ h$ M
11.                                         theApp.m_szHelpFile,
    
12.                                         HH_HELP_CONTEXT,
    & d  j0 N: i; x+ L) S3 o( X, S9 v
13.                                         IDH_WJH_0100000000);
    . S( J  N& P; x% G5 a
14. 
    2 F7 I8 l% a4 L8 l  e3 x1 ^1 ?
15.         return (hWnd != NULL);
    6 l9 I2 [- Z# o! Z6 w
16.         return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
    
17. }

复制代码

　　上述代码即响应用户F1按键，若当前显示界面设置了热点敏感帮助的页面ID时，程序将打开CHM帮助文档并跳转到ID对应的页面；若当前显示界面没有设置热点敏感帮助的页面ID，则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。
0 {+ ?9 @# U  P/ T2 U/ f! ?. _; s二、CHM帮助文档的制作要求

CHM帮助文档必须包含API文档信息，包含页面ID文件和ID对应页面名称申明二个文件，格式如下：
: O& n, U: n5 |3 N
( }  m; z3 E' n$ X5 J8 kCHMHelpID.h 页面ID文件格式：
: e/ e& v* R- B$ T0 M: ]9 u( ~6 _* A#define IDH_WJH_0000000000  0
" B" {( m  v$ E- ~: S/ j- A( {#define IDH_WJH_0100000000  100000000
1 }6 P& V5 e6 W( Q! j#define IDH_WJH_0100100000  100100000
  ~) _4 w* Y3 }, j# e+ n#define IDH_WJH_0100101000  100101000

AliasID.hID对应页面名称申明文件格式： IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操   作   手   册.Htm
IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm
' i  Z, s& S) l- W4 KIDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm
2 g- g9 m5 k- {5 V  M7 |& {, RIDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm
IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm
* r% l- a$ v& N" b: ~3 _, B- T" ?
　　编制好这两文件后，包含在HHP工程文件中，用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件，极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件：Word2CHM帮助文档制作工具，此软件自动将WORD文档按照章节转换成CHM文档，并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。