找回密码
 注册
搜索
查看: 5857|回复: 0

软件热点敏感帮助的实现

[复制链接]
发表于 2006-12-27 12:48:36 | 显示全部楼层 |阅读模式
  很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
* f- \" B" i3 U2 ~" M% X9 R0 F+ d; y$ f' q0 A; ^7 N3 }  f
一、软件中对CHM帮助文档的调用方法4 R# S9 u/ L3 F4 S7 g
7 Z( C9 B" b, [5 d% S$ O! w
  VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。0 W" j' O' F7 W) g0 O& q4 }) n
系统包含文件如下:
. f9 {* V  Z& T$ g& [: Y! Y' K' C7 T9 V! }( W
  1. #include "CHMHelp.h") x, d' n' [" t  J, a& J$ X
  2. " f: m% B/ D# z( t- d. N$ z/ N
  3. BOOL CDataDlg::OnInitDialog() 7 p1 Q: F- @4 ^9 q* C
  4. {
    - M/ Z8 v& [/ s& m
  5.         CDialog::OnInitDialog();! X# z' X# w0 R! G' w0 g4 D: ~
  6.         SetWindowContextHelpId(IDH_WJH_0300702025);
    $ y  y  s' b# n; C# w
  7.         return TRUE;
    , n: a6 j/ n7 ~; b
  8. }
复制代码
& z6 s* ~/ ?2 }0 m/ U' ^+ m
  上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:
  1. BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo) . M9 a5 v  r8 P+ G
  2. {# U8 d1 v! y! H/ M: o! O6 ^+ {" u
  3.         HWND hWnd;
    5 z% J( a7 L& a1 d. c) U# _" U
  4.         if(pHelpInfo->dwContextId > 0) 8 `+ L. O# U2 O+ H9 _" s
  5.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, / y5 B5 M+ S4 T6 x
  6.                                         theApp.m_szHelpFile, ( z2 P# @9 I. e$ ~( A
  7.                                         HH_HELP_CONTEXT, 0 V  ?. o: x, N( \" S1 P
  8.                                         pHelpInfo->dwContextId);
    # W6 L" |  G' ^. W+ o
  9.         else
    8 |: {4 @8 X' R$ m6 D0 S% P
  10.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
    3 W/ B6 N; m6 ~% A2 S$ V
  11.                                         theApp.m_szHelpFile,
    - l$ |7 ^4 d3 \8 z
  12.                                         HH_HELP_CONTEXT, 9 g  s9 x$ Q! L- U) x
  13.                                         IDH_WJH_0100000000);
    * }) I8 ^" C+ n6 w# h, O
  14. + @! O8 r, s3 s, X5 \& c. H
  15.         return (hWnd != NULL);6 L1 i- p5 Q& [" I5 B/ u6 J  @$ s2 M' _, A
  16.         return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
    & Y) a2 F" g7 `8 m. K% Q0 `
  17. }
复制代码

4 |4 k& U/ X5 q+ h. `! ?( V  上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。 8 g+ b5 i9 ]3 E6 o+ z  b! n! B* I& b0 t
二、CHM帮助文档的制作要求 8 v( y+ u: x5 _  V; C& B

8 S1 {# p& \( vCHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下:
1 p. h. a7 a) z
1 b1 @# l( o" {$ d# y, jCHMHelpID.h 页面ID文件格式:" i" n2 f2 h& w8 m" x1 m
#define IDH_WJH_0000000000  0" s  d8 Q, t) R* c% L
#define IDH_WJH_0100000000  1000000006 r; u5 s! o2 D% G( x5 ^
#define IDH_WJH_0100100000  1001000008 U4 k. V9 I9 s8 B/ d
#define IDH_WJH_0100101000  1001010002 A6 X* N* H6 X2 c! n8 \! L

* B; V; U/ }* l; R1 G, |) {AliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操   作   手   册.Htm
3 Q% P0 n- S7 uIDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm: L" F* u5 ]$ j& H1 V
IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm" g- ]* l+ ?) q- C6 D, i: J6 v
IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm
% T$ A" L# ^/ i0 m, A2 XIDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm
) n  N) ]; ]% R1 s1 E* ^# b
' T3 c, K, P, {& P0 J% f% H  编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。
您需要登录后才可以回帖 登录 | 注册

本版积分规则

Archiver|手机版|小黑屋|宁德市腾云网络科技有限公司 ( 闽ICP备2022007940号-5|闽公网安备 35092202000206号 )

GMT+8, 2026-5-2 11:50 , Processed in 0.019551 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表