|
|
很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。1 a* C) | Q" L# {4 q% v1 {8 W
& g3 k q2 H% k( x$ G
一、软件中对CHM帮助文档的调用方法
6 f3 m* n: u9 {( }9 }
7 ^ e4 J9 [$ q7 e8 ` a$ U5 L VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。% E! q0 a+ S1 N1 j. u: h
系统包含文件如下:
# d1 P: _: H9 y0 [( J9 P" H) E3 V* Y1 D
- #include "CHMHelp.h"5 d- l5 F: P% c" e8 c% p% S
- 6 u) D' w: x( v- m& h" S
- BOOL CDataDlg::OnInitDialog()
: ^" y V+ _0 o - {# {( i" `5 d6 m+ R+ w+ R: g
- CDialog::OnInitDialog();
e- e u9 y0 O" n - SetWindowContextHelpId(IDH_WJH_0300702025);3 ?( [2 X/ V9 Y/ B
- return TRUE;% I* V- B* z% |* w) c+ _% m
- }
复制代码
- ^, u" _' y6 V3 R. R7 K4 \ 上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:- BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo)
5 V9 J% N! a. Q. U; ` - {
& x! o( w. m- L) w+ n - HWND hWnd;: a8 z; H7 i" {
- if(pHelpInfo->dwContextId > 0) : q: A3 J: z+ L( ~/ Y/ r9 {
- hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
9 X4 z: @( N7 e4 A( I - theApp.m_szHelpFile, 5 E' }4 z3 Q$ [3 a* x
- HH_HELP_CONTEXT,
' q+ o4 U! `( a& O& p# ]$ v' N* ? - pHelpInfo->dwContextId);" C+ A1 o+ v7 D
- else - a' u! z6 i* t% z- }3 C
- hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
' Q, [; [2 \+ U% G" _1 \7 @, l+ m - theApp.m_szHelpFile,
' \2 G1 J; _$ J( ?* c( k0 O& t* R - HH_HELP_CONTEXT, ! u" L% Q- r; \+ w8 u4 A
- IDH_WJH_0100000000);
9 O& T' j$ {' z0 U
! W! f, a5 l8 B. {8 V4 Y- return (hWnd != NULL);
) O" J; u$ n9 B7 c4 D$ S5 c - return CMDIFrameWnd::OnHelpInfo(pHelpInfo);$ }$ K% s6 Q9 D( f" j
- }
复制代码 ( h- _. H: V( Y, w
上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。 f2 @# R" s' i
二、CHM帮助文档的制作要求 . T3 k, `% N: t; ~* X
; Q5 o5 L$ X0 D9 U0 eCHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下:
9 D& j: ~/ k; ]+ ~# ]6 M
6 {. t, E; q' p. ECHMHelpID.h 页面ID文件格式:) } q5 L% H+ e: J9 l6 b; m r
#define IDH_WJH_0000000000 0, y/ ]$ j, ]5 z
#define IDH_WJH_0100000000 100000000/ z) W3 F. _$ {! i+ u
#define IDH_WJH_0100100000 1001000007 _) o& {) s- [: [
#define IDH_WJH_0100101000 100101000% b6 G* U' y: h2 ]. O
- R, `0 \4 u/ W4 @0 D
AliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操 作 手 册.Htm
3 x4 g9 M2 c/ b4 @IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm! Q8 ^% r5 s$ i2 e7 v5 q: J2 [$ H
IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm' k/ m: W" Q0 S- U5 c
IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm
" C' n2 E. i) m' [ T( m Q3 lIDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm
2 K; w" u" f" x- D( u3 E$ t2 c. ]2 ?4 C$ V) P: J1 t' i
编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。 |
|