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

软件热点敏感帮助的实现

[复制链接]
发表于 2006-12-27 12:48:36 | 显示全部楼层 |阅读模式
  很多人问起现在的CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍在VC开发的软件中对CHM帮助文档的调用方法以及CHM帮助文档的制作要求。
9 U8 [2 K* X! O3 ?% O! L
; ^/ A' \* k: C) `2 n  i一、软件中对CHM帮助文档的调用方法
% j, r) j4 z2 z3 ~5 s
: T; e  a' P+ L" I  VC中调用CHM帮助必须用API函数HtmlHelp(),此函数在LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所在的目录,然后包含CHMHelp.h头文件即可。
8 a% D- _' e' s2 T. T! n0 d系统包含文件如下: ! N0 \2 `/ _7 O5 L  m& x5 o
3 Q4 o( ]% z& Y/ J2 r& I
  1. #include "CHMHelp.h", f  ~3 s2 H' O* _! s0 J0 \% q
  2. + h# |  ~8 z9 d/ H3 ?
  3. BOOL CDataDlg::OnInitDialog() . x( P4 x6 P6 b( B# ?% t
  4. {2 k, Z$ g: K3 u9 w! c( z) Z' _4 r
  5.         CDialog::OnInitDialog();( R% a9 v( C" D7 A# y+ y, L
  6.         SetWindowContextHelpId(IDH_WJH_0300702025);8 I  v, ?1 k  @
  7.         return TRUE;2 B8 W/ v- H; q4 @0 _) s! B
  8. }
复制代码
& \. s2 M5 i" ]* M; r# _" b: l" v5 W
  上述代码中IDH_WJH_0300702025为在CHMHelpID.h中定义的敏感帮助的页面ID,设置了ID后在需要显示帮助的过程中(一般是用户按F1)增加如下代码:
  1. BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo)
    . j5 D5 l* i' t) T; i* E$ O
  2. {
    % I# e# `" U' s4 z
  3.         HWND hWnd;) I+ C/ c  g* _, L
  4.         if(pHelpInfo->dwContextId > 0) $ N3 e; S8 J; l3 N2 y
  5.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle,
    5 e0 Z. w8 p. N+ q
  6.                                         theApp.m_szHelpFile,
    0 \+ e, D" y/ Q+ q/ K  {; _6 h
  7.                                         HH_HELP_CONTEXT, ) r" T" M9 T& J4 o# i; r' H
  8.                                         pHelpInfo->dwContextId);
    5 y: S5 Y+ S( |( X% b$ q
  9.         else . X- L1 V5 e3 x  }1 T
  10.                         hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, ( Z) F1 t1 W3 x" H5 x
  11.                                         theApp.m_szHelpFile,
    & r# L5 ]6 q* q! @' r; n/ i- @. O8 j
  12.                                         HH_HELP_CONTEXT,
    ; g. ]- g' |8 {9 E/ B( n
  13.                                         IDH_WJH_0100000000);
    7 _6 S4 p* f* ^1 d; A9 p

  14. 2 t; v' K% U4 D' v  d# S: c9 j! n$ G$ K
  15.         return (hWnd != NULL);
    0 T5 N. q3 h( l6 t
  16.         return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
    4 S  Y6 k0 C+ Q  [1 S
  17. }
复制代码
: P* A7 h) g# U/ |- d
  上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。
& R* ^8 B. y1 @8 g4 {二、CHM帮助文档的制作要求 " t* Y5 U! m, _
; d0 R2 ?2 X& v( g* w
CHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下:
5 D/ F4 j: T7 l" B$ `" d8 P7 L' D
' W" c& X' N1 C+ l. YCHMHelpID.h 页面ID文件格式:6 H0 }4 k% E3 D4 |# Y& i, P7 y) Y
#define IDH_WJH_0000000000  0  D1 {- O' b' H3 V! Q
#define IDH_WJH_0100000000  100000000
% W5 N  G" r7 j- w0 h#define IDH_WJH_0100100000  100100000+ M( I% ~* n+ g
#define IDH_WJH_0100101000  100101000# d& _# o* N- R% t  Q

& H7 E' L, o# ]1 u' R- ?3 JAliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操   作   手   册.Htm5 L* ~! w2 S; r. w" a# w
IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm
  N. B9 y, F! a  nIDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm( Q: i4 Z* \9 @6 }
IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm& b; |; B8 V3 C! `! F
IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm/ _! Y* z$ W1 ^5 s
- h6 Z" t/ X; J7 o4 `3 e. _0 |
  编制好这两文件后,包含在HHP工程文件中,用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。
您需要登录后才可以回帖 登录 | 注册

本版积分规则

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

GMT+8, 2026-6-18 13:06 , Processed in 0.018192 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

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