|
|
很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
' O4 E# w1 x' X2 {1 v* @, r
& A2 t' J4 ^4 o. t; H( t8 N一、软件中对CHM帮助文档的调用方法3 e' k! b7 [* l2 S
/ G3 `( `# e- E- ^0 ^ VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。0 Z1 X. _* \+ q5 _: F
系统包含文件如下: p. X) h5 c: q' f+ U
5 O$ _7 X$ N0 e+ |1 x- S
- #include "CHMHelp.h"7 E2 R* _& C" ~6 a8 g0 [. G
9 k4 X6 t0 N: O( V4 L- BOOL CDataDlg::OnInitDialog() + G) O1 e) W; p: V' V' W& _
- {/ U( W* n2 y: w/ f$ x, e
- CDialog::OnInitDialog();% V9 g0 E8 `& p n2 e9 m4 g% g
- SetWindowContextHelpId(IDH_WJH_0300702025);
( |. d- e- D# r! v0 V H2 a' l - return TRUE;; B) ^& B: U D. o
- }
复制代码
: U2 y) Y% Y8 m2 P s 上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:- BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo) & n( z8 H1 E: Y, v; z( C9 M
- {, |( s: x$ }& h: _+ w4 D l
- HWND hWnd;
9 {. ~+ Q+ N7 O; W" } - if(pHelpInfo->dwContextId > 0)
; M& `4 Q! r( `" h - hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, , b9 h. ], z3 Y" L3 U' ?: l! G
- theApp.m_szHelpFile,
0 u. e4 I. X( X+ | - HH_HELP_CONTEXT,
4 k0 I0 ^+ ~) T) x - pHelpInfo->dwContextId);, i* Q- f6 d7 _* Q0 a+ z% B
- else ! P |9 ~- \) d+ t0 K
- hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
5 A% b& @) u; a - theApp.m_szHelpFile, 1 y+ y, C7 d9 J W$ _
- HH_HELP_CONTEXT,
! [2 [; y: s( z: ` M4 H0 f - IDH_WJH_0100000000);- Y) L% F1 @! d
- % \3 w0 z# s7 X5 t3 @+ f' y8 F
- return (hWnd != NULL);
" v* m5 _8 z+ T - return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
! S; y; @' b2 e: U, g5 v9 f1 ` - }
复制代码
, ?* }6 R8 b3 j) p' A2 t% ~ 上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。 * U9 {2 u& u9 Q: ]/ B4 r; l, ?
二、CHM帮助文档的制作要求
& I, j' k' x; A; \$ Y" u* d' |" C+ f) a$ t; @& C" N- V7 b' s! z$ a
CHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下: ) h* R0 G' X6 |2 ]
5 p7 F* i U( q/ e8 }CHMHelpID.h 页面ID文件格式:6 g' }) y0 H# Q- G! c
#define IDH_WJH_0000000000 0
- w/ U; u9 ~8 h#define IDH_WJH_0100000000 100000000
3 G) Q. G; L0 Q( A0 R$ O- ?. ^#define IDH_WJH_0100100000 100100000
+ N& ^$ Y$ T$ E6 i#define IDH_WJH_0100101000 100101000
5 A( p: G. z8 E8 |) N9 q, R' d6 Y+ s0 j8 } Q! i
AliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操 作 手 册.Htm
1 u h2 U6 U5 l9 t5 ~* g: {IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm
' q* u) d& @/ Q' y+ Y: V3 xIDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm
; s Z2 b2 A3 _* z0 k7 X, fIDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm, ?6 j4 o8 L$ C
IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm/ c; ~: N/ ?! I u
! Q& b" L# Z& a# R" ^) k
编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。 |
|