|
|
很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
7 a) Z7 [. [) x. n* E7 B* z7 [
' x+ p" [. Q- w! [0 E一、软件中对CHM帮助文档的调用方法 T* g1 P1 h: m1 O7 h% q
+ v1 T, [3 t9 C& C: D& X; S) k/ \+ X, w
VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。
% P `6 a9 g; T! ?' {系统包含文件如下: + Y, [" }+ ]/ L8 t j
7 d" A- W5 U+ Z0 U' [. k8 Y- #include "CHMHelp.h". S& c6 n5 C; \$ M5 t& G* y2 ~$ U
& M9 D; J& m+ @9 }) |- BOOL CDataDlg::OnInitDialog()
( N- c6 G% E A' _! U* @; d8 \$ D - {
2 n) u r$ N: T# [$ V - CDialog::OnInitDialog();
9 W5 \3 {5 a" R. L - SetWindowContextHelpId(IDH_WJH_0300702025);1 @6 B, f# ^# n$ w- t; l9 r# |
- return TRUE;
( b( W4 G* R( e; ~4 b k# v - }
复制代码 " T) w8 | z1 y; ? b9 ~! \, q
上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:- BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo) ; `) `% d8 T+ ^2 c" C# q
- {) l5 U+ n, _% x6 ~! k/ m3 T
- HWND hWnd;" s2 g* _2 q: Y
- if(pHelpInfo->dwContextId > 0) ; m1 t8 C: N) H* g+ y; Z2 N) v3 t
- hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, }% e7 B4 |2 K7 C4 U- U3 h" L
- theApp.m_szHelpFile,
# _1 t7 |+ q D; \+ [ - HH_HELP_CONTEXT,
3 N' W3 }/ E: w5 j& |; J1 p1 ~2 G - pHelpInfo->dwContextId);% N1 T& I z) c
- else
0 \3 `: M4 W. n - hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
( A0 S0 F* r" a2 _+ j - theApp.m_szHelpFile, ' [ `* [! ]7 _& K" u
- HH_HELP_CONTEXT, 4 a/ J7 ]- y- Z' P9 M
- IDH_WJH_0100000000);/ F D# i% k8 B; X- T0 a, _9 J
- 7 p0 c; |0 V6 [+ {- E8 }: Z
- return (hWnd != NULL);
& R4 @0 U6 L& q. y, e" f) ?+ `0 ^ - return CMDIFrameWnd::OnHelpInfo(pHelpInfo);" o$ H) Y$ ], A, M2 J
- }
复制代码
2 T6 x( ?7 a! ~, Z& a 上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。
: x+ t4 x- ]. a) d/ P二、CHM帮助文档的制作要求
- U. ]* k& Y3 H T `' ?4 }) W A3 P& O* ]6 R* V( W
CHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下:
1 Z4 \- A6 v& S
8 ^. @& X6 \$ E8 lCHMHelpID.h 页面ID文件格式:/ r$ e8 V2 K( D/ o ]8 Q
#define IDH_WJH_0000000000 0: o" D7 J' a& J! z5 ^
#define IDH_WJH_0100000000 100000000) |/ i. z# Y ^
#define IDH_WJH_0100100000 1001000001 c8 ?5 {) t' o5 d* s
#define IDH_WJH_0100101000 100101000
( R8 V% f |) R. s% O- ^/ \, a+ K
AliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操 作 手 册.Htm
8 i7 T& ?3 n e1 V0 ], ^IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm) [" p( J$ n3 g, Z. j
IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm
1 W- w% ~8 _7 O1 \4 ~7 QIDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm# V9 w" S6 j8 h/ X% R
IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm
2 ]& s t" j g/ j" H, a9 h6 F: f& @) K4 Z
编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。 |
|