在 VC 中使用 HTMLHELP (.chm) 帮助文件

  在我用VC调用了HTML Help之后,才发现用VC调用HTML Help并不是一件简单的事。

  在Visual C++ 6中调用HTML Help没有现成的函数,需要调用HtmlHelp()这个API函数。而在调用这个函数之前,还需要在你的工程中加上HtmlHelp的库和头文件:

  1. 指定HtmlHelp.h的路径。选择菜单“Project -> Settings...”,打开“Project Settings”对话框。选中“C/C++”选项卡,选择“Category”列表框的内容为“Preprocesor”,在“Additional include directories”项中填入包含“HtmlHelp.h”这一文件的路径。这个文件你可以在你的硬盘上找,如果你安装了“HTML Help Workshop”,那么在“HTML Help Workshop”程序目录下有个“Include”目录就是。


  2. 指定HtmlHelp.lib的路径。按照与前面类似的方法,选择“Link”选项卡,选择“Category”为“Input”,在“Additional library path”中填入包含“HtmlHelp.lib”文件的路径。同样,在“HTML Help Workshop”程序目录下的"Lib"目录就是。


  3. 指定Lib文件。同样在“Link”选项卡中,选择“Category”为“General”,在“Object/librarie module”中填入“HtmlHelp.lib”。


  4. 最后,将HtmlHelp.h包含在程序中。你可以选择一个合适的位置加入“#include ”这一句话,但我建议你将这句话加入到“Stdafx.h”中。


  注:以上所有内容在MSDN的“Including HTML Help Support Files in an Application”主题中均有介绍,在“搜索”选项卡中输入查找内容为“HtmlHelp”即可找到该主题。

  最后是大家都关心的问题,如何在程序中调用HTML Help。

  如同在Visual Basic 6中使用HTML Help一样,首先需要定位帮助文件的位置。假如我们把帮助文件(.chm)放在程序路径下,那么我们该如何去获得程序路径呢?程序大本营上是使用的API函数GetModuleFileName(),例如,我使用以下代码定位程序路径和取文件的完整路径文件名:

  CString appPath;


  GetModuleFileName(NULL, appPath.GetBuffer(MAX_PATH), MAX_PATH);


  //注:使用该API函数得到的是程序文件完整路径文件名,去掉文件名后才是路径。


  appPath.ReleaseBuffer();
  int n = appPath.ReverseFind('/');
  CString helpFile;
  helpFile = appPath.Left(n);
  TCHAR c = helpFile.GetAt(n - 1);
  if(c == '/')
    helpFile += "HtmlHelp.chm";
  else
    helpFile += "/HtmlHelp.chm";

通过HtmlHelp调用帮助文件(.chm)的程序代码如下:

  HtmlHelp(NULL, (LPCSTR)helpFile, HH_DISPLAY_TOPIC, 0);


  //直接打开帮助文件的默认主题。

  或

  HtmlHelp(NULL, (LPCSTR)helpFile, HH_HELP_CONTEXT, 1);


  //打开其中一个主题,实现上下文相关的帮助调用。

  如此,在Visual C++ 6中,你也能调用HtmlHelp了。这次可是用的API函数,也就是说,略为改动你就可以用于……

  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

  很多人问起现CHM帮助文档如何作为软件的热点敏感帮助,网上搜索的资料也不多,可能是太简单了吧,呵呵!今天整理了一下,详细的介绍VC开发的软件CHM帮助文档的调用方法以及CHM帮助文档的制作要求。 一、软件CHM帮助文档的调用方法   VC调用CHM帮助必须用API函数HtmlHelp(),此函数LIB库函数内,为方便调用,我把它整体打包了,您要做的就是把它放到VC工程所的目录,然后包含CHMHelp.h头文件即可。 系统包含文件如下: #include "CHMHelp.h" BOOL CDataDlg::OnInitDialog() { CDialog::OnInitDialog(); SetWindowContextHelpId(IDH_WJH_0300702025); return TRUE; }   上述代码IDH_WJH_0300702025为CHMHelpID.h定义的敏感帮助的页面ID,设置了ID后需要显示帮助的过程(一般是用户按F1)增加如下代码: BOOL CMainFrame::OnHelpInfo(HELPINFO* pHelpInfo) { HWND hWnd; if(pHelpInfo->dwContextId > 0) hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, theApp.m_szHelpFile, HH_HELP_CONTEXT, pHelpInfo->dwContextId); else hWnd = HtmlHelp((HWND)pHelpInfo->hItemHandle, theApp.m_szHelpFile, HH_HELP_CONTEXT, IDH_WJH_0100000000); return (hWnd != NULL); return CMDIFrameWnd::OnHelpInfo(pHelpInfo); }    上述代码即响应用户F1按键,若当前显示界面设置了热点敏感帮助的页面ID时,程序将打开CHM帮助文档并跳转到ID对应的页面;若当前显示界面没有设置热点敏感帮助的页面ID,则显示软件帮助缺省的页面。IDH_WJH_0100000000为软件的缺省显示页面ID。 二、CHM帮助文档的制作要求 CHM帮助文档必须包含API文档信息,包含页面ID文件和ID对应页面名称申明二个文件,格式如下: CHMHelpID.h 页面ID文件格式: #define IDH_WJH_0000000000 0 #define IDH_WJH_0100000000 100000000 #define IDH_WJH_0100100000 100100000 #define IDH_WJH_0100101000 100101000 AliasID.hID对应页面名称申明文件格式: IDH_WJH_0000000000 = 用户操作手册.Content\0000000000_操 作 手 册.Htm IDH_WJH_0100000000 = 用户操作手册.Content\0100000000_第一部分 系统介绍.Htm IDH_WJH_0100100000 = 用户操作手册.Content\0100100000_第一章 主要功能.Htm IDH_WJH_0100101000 = 用户操作手册.Content\0100101000_1、基本功能.Htm IDH_WJH_0100102000 = 用户操作手册.Content\0100102000_2、高级应用功能.Htm   编制好这两文件后,包含HHP工程文件,用HTML WORK SHOP进行编译就可以了。 现网上也有很多软件可以按照WORD文档的章节自动生成上述文件,极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件:Word2CHM帮助文档制作工具,此软件自动将WORD文档按照章节转换成CHM文档,并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法VC下加入代码编译软件即可实现热点敏感帮助
©️2021 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值