|
|
很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。) L0 v, B; e4 C
D" ?+ |1 O, Q
一、软件中对CHM帮助文档的调用方法, |- x4 P9 K$ [. @2 Z4 `6 O* q
2 ^0 r7 c6 _1 N$ w VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。; c5 m! E+ [9 C4 X' ^, n- V% e8 \0 ?
系统包含文件如下:
2 k( J% m$ f* p. ~) N. k( p
$ m+ t: [) @* \+ S$ n- #include "CHMHelp.h"
2 U# O1 j0 G1 }4 q3 D! R: f
8 g7 x- ~% A9 u* N% _3 E* |2 j- BOOL CDataDlg::OnInitDialog() + \% W3 V# ~8 y) H
- {
6 O. m, R6 o( A8 \3 f9 A6 x, p - CDialog::OnInitDialog(); L+ y' S- _! Y+ I7 n3 ^5 Z' E
- SetWindowContextHelpId(IDH_WJH_0300702025);
- a* e/ \2 ^! ^- N# d* }9 P0 p - return TRUE;
& l' ?8 k0 b1 Q9 V1 C - }
复制代码 % M, ?- O' }' p% `- N
上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:- BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo) 7 F5 d& J1 l! L$ s
- {4 m9 k( P) {( c/ h3 a% {+ N
- HWND hWnd;
6 L0 r) P; p( E6 V' ] - if(pHelpInfo->dwContextId > 0) 8 e2 d1 {$ r5 \6 h
- hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
% j; J) x0 O! X& q! p3 E' y - theApp.m_szHelpFile, % s! B2 j* T: V& a
- HH_HELP_CONTEXT,
' Y0 R: w# K- y" P - pHelpInfo->dwContextId);
3 h. b! H, m+ G9 v, s+ P - else
, p; A5 S) Z+ I - hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, 3 ^5 A: V4 }2 m: j
- theApp.m_szHelpFile, % U' x& @ P) a
- HH_HELP_CONTEXT, 5 p& S: ^2 V& T4 V' k$ Q( L" m
- IDH_WJH_0100000000);
& K2 F& e% x$ t( U( j7 S - " F$ H1 O: }4 s; }
- return (hWnd != NULL);* y2 f E% Z0 x
- return CMDIFrameWnd::OnHelpInfo(pHelpInfo);7 w. |- ^& B2 z* F! p
- }
复制代码 ! H5 X6 a4 M7 v7 ?* l. ? O
上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。 + p7 [5 m& I3 i) k
二、CHM帮助文档的制作要求 5 `+ b+ [3 ?. O& n
5 s$ \$ s9 O" V8 G! C4 _' LCHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下: + V3 a+ l. y ~& J1 \, n3 F0 ^
9 P% d, I# i1 a& E
CHMHelpID.h 页面ID文件格式:
: B6 `' X1 E, C8 B) D/ x+ \4 @#define IDH_WJH_0000000000 0
9 S. r( D( L b#define IDH_WJH_0100000000 1000000005 u- K& H0 ]" G. d* |
#define IDH_WJH_0100100000 1001000001 A+ ]9 i" e9 |# s: G6 |2 a
#define IDH_WJH_0100101000 1001010005 S- N2 b; A' ]' K4 z' m
' {" q( K& X9 @2 K1 w- ?( z# oAliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操 作 手 册.Htm
+ r( b, A# m1 s& g0 \% v- DIDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm: A2 U R" S+ Y& [- F& \- t
IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm
/ G' D3 T- o0 ~; @+ [5 `% B+ u% |IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm: J: O, W5 ^# v9 |
IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm' m) C6 x* }- I# r3 K( H/ L! u
# }" V& ?- w c }: A& W! _ 编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。 |
|