软件热点敏感帮助的实现

天云上人

　　很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助，网上搜索的资料也不多，可能是太简单了吧，呵呵！今天整理了一下，详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
. t* G  ~/ t( v# ~. Q! J
一、软件中对CHM帮助文档的调用方法
8 @" P3 t& A- \; D* v) @
　　VC中调用CHM帮助必须用API函数HtmlHelp()，此函数在LIB库函数内，为方便调用，我把它整体打包了，您要做的就是把它放到VC工程所在的目录，然后包含CHMHelp.h头文件即可。
6 L1 z! l9 y4 f9 z, M  A$ U系统包含文件如下：
( k( B6 f. m1 E; R1 ^

1. #include "CHMHelp.h"
   ) s( k5 j8 }; z9 ^4 J: i
2. 
   
3. BOOL CDataDlg::OnInitDialog()
   # G  ~9 X9 B$ _) g4 {
4. {
   4 ^& ^4 M* V. E. z! M
5.         CDialog::OnInitDialog();
   ! M# O& y, D9 A5 t+ s
6.         SetWindowContextHelpId(IDH_WJH_0300702025);
   
7.         return TRUE;
   
8. }

复制代码

- ~- @+ J/ E" W  M# h　　上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID，设置了ID后在需要显示帮助的过程中（一般是用户按F1）增加如下代码：

1. BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo)
   
2. {
   
3.         HWND hWnd;
   
4.         if(pHelpInfo->dwContextId > 0)
   , w- j3 {, w3 w7 Q0 D' V5 J
5.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
   
6.                                         theApp.m_szHelpFile,
   + D- i9 Z5 |* x9 D3 m  R! g9 v2 {
7.                                         HH_HELP_CONTEXT,
   * m) W8 D7 A0 H- B% |
8.                                         pHelpInfo->dwContextId);
   
9.         else
   0 \9 u, Q) U! Q4 ~* z4 G! g
10.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
    
11.                                         theApp.m_szHelpFile,
    * J9 y) y* ^3 s! s& Y' `/ I  w7 G. ~
12.                                         HH_HELP_CONTEXT,
    0 @( i& ?7 @: S. ]3 b$ n) A
13.                                         IDH_WJH_0100000000);
    2 c. E! S7 M' @. d0 q
14. 
    
15.         return (hWnd != NULL);
    8 W1 t/ L( L+ U8 |) l) f
16.         return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
    & Y) B; r$ E; y% ~8 c" ~. u  T
17. }

复制代码

　　上述代码即响应用户F1按键，若当前显示界面设置了热点敏感帮助的页面ID时，程序将打开CHM帮助文档并跳转到ID对应的页面；若当前显示界面没有设置热点敏感帮助的页面ID，则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。
二、CHM帮助文档的制作要求
$ v* T) w, I4 m4 t
' d4 a( m0 `( k# I. iCHM帮助文档必须包含API文档信息，包含页面ID文件和ID对应页面名称申明二个文件，格式如下：
. @4 d' w$ C+ L* A- @  ]
" ~) y- Q( C2 n7 j. M+ fCHMHelpID.h 页面ID文件格式：
, S2 R8 L# ^) Q: H* D  v#define IDH_WJH_0000000000  0
1 ~7 O$ v  U* }; h#define IDH_WJH_0100000000  100000000
; }; T% ]7 s! A. h. |! e  L) f#define IDH_WJH_0100100000  100100000
#define IDH_WJH_0100101000  100101000
/ B0 e0 n1 ^( m; F% m: s: f
AliasID.hID对应页面名称申明文件格式： IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操   作   手   册.Htm
IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm
; C  `$ V+ A% OIDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm
IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm
+ r0 M" ^2 B& y+ V( O% K- S& l; GIDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm
9 Y7 E/ s: {( T4 T" V+ O" H
　　编制好这两文件后，包含在HHP工程文件中，用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件，极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件：Word2CHM帮助文档制作工具，此软件自动将WORD文档按照章节转换成CHM文档，并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。