软件热点敏感帮助的实现

天云上人

　　很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助，网上搜索的资料也不多，可能是太简单了吧，呵呵！今天整理了一下，详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
3 f9 X( V+ y5 |
一、软件中对CHM帮助文档的调用方法
( n) F! ]# H2 M- n1 n  }" M4 `
( G. @+ ?1 A5 e- ~8 U　　VC中调用CHM帮助必须用API函数HtmlHelp()，此函数在LIB库函数内，为方便调用，我把它整体打包了，您要做的就是把它放到VC工程所在的目录，然后包含CHMHelp.h头文件即可。
5 ~& k9 v1 A, H9 w$ B7 \0 k系统包含文件如下：
, ^5 _+ h- N- s, b' V
8 n- e  E3 K/ T6 B; u$ c  k

1. #include "CHMHelp.h"
   
2. 
   
3. BOOL CDataDlg::OnInitDialog()
   . Q3 J4 P& P, w  p' v; I: U
4. {
   . D. q: c% @! ]( F: _+ \
5.         CDialog::OnInitDialog();
   
6.         SetWindowContextHelpId(IDH_WJH_0300702025);
   - B$ c  n5 i! F+ A* ?) g( X0 R8 b
7.         return TRUE;
   
8. }

复制代码

  T# G: H$ b2 S/ \% |  D8 z　　上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID，设置了ID后在需要显示帮助的过程中（一般是用户按F1）增加如下代码：

1. BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo)
   
2. {
   5 T/ b& ^9 R7 D! h# a1 n+ ^& h; q# h
3.         HWND hWnd;
   ! f( M1 k; w2 v9 P9 e
4.         if(pHelpInfo->dwContextId > 0)
   7 u6 w) D: p2 ~' p6 i+ e% _
5.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
   
6.                                         theApp.m_szHelpFile,
   1 y! \5 Y  g1 W, `2 P4 X, s& u' t
7.                                         HH_HELP_CONTEXT,
   " L$ l3 c) P- s
8.                                         pHelpInfo->dwContextId);
   
9.         else
     f7 a) w5 N8 N/ u. p1 P8 I8 w8 f
10.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
    $ I6 \# E# d& ~+ e  ?
11.                                         theApp.m_szHelpFile,
    + \5 G$ M/ G7 P5 G; z% _0 X
12.                                         HH_HELP_CONTEXT,
    9 z  ~! c' w: R6 b( \0 M& w, M
13.                                         IDH_WJH_0100000000);
    
14. 
    
15.         return (hWnd != NULL);
    # n! D: v& J8 Q! B
16.         return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
    " u! X3 t) X5 b. Z* K9 L6 y. f
17. }

复制代码

　　上述代码即响应用户F1按键，若当前显示界面设置了热点敏感帮助的页面ID时，程序将打开CHM帮助文档并跳转到ID对应的页面；若当前显示界面没有设置热点敏感帮助的页面ID，则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。
' D4 U! w4 i# E8 X# w2 n二、CHM帮助文档的制作要求

, x6 M6 k6 k/ |. |3 ~CHM帮助文档必须包含API文档信息，包含页面ID文件和ID对应页面名称申明二个文件，格式如下：
, Z) w& }, s! C$ a1 {! U
CHMHelpID.h 页面ID文件格式：
: r7 k( t- ~! e$ _. M# h& v#define IDH_WJH_0000000000  0
#define IDH_WJH_0100000000  100000000
#define IDH_WJH_0100100000  100100000
#define IDH_WJH_0100101000  100101000

3 ^! ^/ D3 T' J' kAliasID.hID对应页面名称申明文件格式： IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操   作   手   册.Htm
3 {1 R2 u2 C4 n6 ~; O' a, ^7 iIDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm
4 ]+ U% s& A8 }1 {* @IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm
IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm
# G! y9 B3 R0 h6 f; F1 T% t* MIDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm
. e; ^8 M$ A: z5 X) h  p
/ k9 N- `0 M. C1 [3 ~) Q8 \　　编制好这两文件后，包含在HHP工程文件中，用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件，极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件：Word2CHM帮助文档制作工具，此软件自动将WORD文档按照章节转换成CHM文档，并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。