|
|
很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
/ S8 y+ F' O& ~* C7 X8 `8 L4 }! O4 {4 Y! S3 B( a
一、软件中对CHM帮助文档的调用方法" ]6 Z# l% r t$ ]
& A+ k! H0 b0 g# y3 W
VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。
5 P& c! Z% W# j. u* O: p! }系统包含文件如下: # A- x3 z( A1 e5 j X3 i
6 h4 {' k( I7 b Z
- #include "CHMHelp.h"
& |. }# H7 \# ~# d1 @) S! s - 0 ^* C' j! [6 `& P& O2 b8 z* f
- BOOL CDataDlg::OnInitDialog()
4 P; Y2 r. g! e A. g/ a" C7 B0 C - {" o' m: v) z" ?/ h; O/ v! u
- CDialog::OnInitDialog();. [7 {0 g- H! x$ m% I
- SetWindowContextHelpId(IDH_WJH_0300702025);# A6 v5 z) r2 x; u/ u+ l6 u. _: T
- return TRUE;
5 S1 E' y$ \/ ~8 x7 z$ } - }
复制代码 - A; K# G6 q" i4 c
上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:- BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo) # o; P) R; l- S1 `! b9 f
- {
' o, K2 M" b% d - HWND hWnd;
0 L2 H) W5 E4 z4 s" P( J: M - if(pHelpInfo->dwContextId > 0) & l8 a6 w+ g$ @2 H Z: T9 p! N
- hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, 5 b/ f( X3 K1 v n
- theApp.m_szHelpFile,
: Y8 J- w* B& j- B5 x - HH_HELP_CONTEXT,
& f( G7 }. V5 t Y) y - pHelpInfo->dwContextId);/ O2 N' z3 m4 i, }
- else
; a. l- ^6 G& {" j) o" k - hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
% Q9 c4 G) g5 |/ r9 I+ S1 m - theApp.m_szHelpFile, 3 r: w3 k; B$ d4 D6 f
- HH_HELP_CONTEXT, ) _) {2 x: ]6 c& E2 g1 W% U/ T. Y
- IDH_WJH_0100000000);' z+ o9 Y' ]- a2 E0 \: k3 b" m6 s
- : W! E5 g9 a* h/ ]. @ t
- return (hWnd != NULL);
6 Y# d- D3 W. F0 }6 s - return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
' E- k3 i7 N; G* q - }
复制代码 0 j- o$ I- x7 [7 {/ t% r: c
上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。 ! P7 j& V0 M, ]7 [2 d) C
二、CHM帮助文档的制作要求 2 j6 U& y& a- R5 c" C5 y5 h' _
; q1 C6 w" a7 d0 f* vCHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下: X3 c) p; c9 ` B, f8 p( W
1 L5 }. l* E H8 X2 P4 M/ ?
CHMHelpID.h 页面ID文件格式:0 X5 ~5 p4 ?3 r7 \1 O
#define IDH_WJH_0000000000 0
! @0 q: Q' s5 @#define IDH_WJH_0100000000 100000000
$ y. o3 Q8 R; ~+ S9 G) \/ Y, R+ J#define IDH_WJH_0100100000 100100000. \- X+ L4 ]& s$ ^& y+ L# D
#define IDH_WJH_0100101000 100101000
/ y) p" x% ~% v c5 i, W2 u& U! p" K1 m4 |0 h5 O
AliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操 作 手 册.Htm4 H0 Y! ]* O3 Y# h. L
IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm# T p P2 ^- y% J3 L6 C. x7 u
IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm3 O) m/ x' n* [- ]" O: W+ z: c' u
IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm3 N7 A) r4 Y5 V6 Z7 b
IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm4 k/ Z7 W7 I+ V
8 Q5 `$ t }2 G: N4 v8 h 编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。 |
|