VC中调用CHM帮助文件

Visual C++ 编程 专栏收录该内容
1 篇文章 0 订阅

VC中调用CHM文件主要是用HTML Help Workshop SDK中的HtmlHelp函数。


如果没有安装HTML Help Workshop,可以从Microsoft网站下载:

 http://msdn.microsoft.com/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp


HTML Help API Reference中关于HtmlHelp()函数的说明如下:

HWND HtmlHelp(
              HWND    hwndCaller,
              LPCSTR  pszFile,
              UINT    uCommand,
              DWORD   dwData) ;


参数/描述

 
hwndCaller
 指定调用HtmlHelp()的窗体句柄。帮助窗体就是属于该窗体。帮助窗体关闭后,HtmlHelp() 将焦点返回给其所属窗体,其所属窗体是桌面的
情况除外。若hwndCaller 为桌面,则由操作系统确定焦点返回到何处。另外,若HtmlHelp() 从帮助窗体发送了任何通知消息,这些消息也将被发送到hwndCaller,这种情况就像你激活了在帮助窗体中定义的通知消息跟踪机制一样。
 
pszFile
 pszFile 参数依赖于uCommand 的值,其作用是指定文件路径,文件可以是编译好的.chm文件,也可以是指定的.chm文件中的一个主题文件(一
般是.htm或.html)。同样也可以通过在前面加一个大于号(>)来指定一个窗体类型名称,如果指定命令不请求文件,则参数值可以为NULL。
 
uCommand
 指定完成的命令。
 
dwData
 指定任何可能需要的数据,以uCommand 参数的值为基础。
 

返回值

根据 uCommand指定的值和其影响,HtmlHelp() 返回下列的一种或两种值:

1、帮助窗体的句柄。
2、NULL。某些情况下, NULL 表示失败;另外, NULL 表明帮助窗体没有创建。


要成功调用CHM文件,还必须在VC开发环境中将HtmlHelp.h和HtmlHelp.lib加入工程中,具体步骤如下:


Project->Settings(Alt+F7)。


1、在C/C++选项卡的Category的列表中选择Preprocessor,在Additional include directories框中填入HtmlHelp.h的地址(例如:

C:/Program Files/HTML Help Workshop/include/htmlhelp.h)。
2、在Link选项卡的Gategory的列表中选择Input,在Additional library path框中填入HtmlHelp.lib的地址(例如:C:/Program Files/HTML

Help Workshop/lib/htmlhelp.lib)。
3、在Link选项卡的Gategory的列表中选择General,在Object/library modules框中填入HtmlHelp.lib。
 

假设要调用CHM的应用程序为SDI程序,且编译好的帮助文件和程序在同一目录下。(示例代码中CHM文件名为HELP.CHM,GetModuleFileName用于获得帮助文件路径。)


1、在stdafx.h中加入HtmlHelp.h:#include "HtmlHelp.h"
2、调用CHM:

char szFilePath[MAX_PATH],szPath[MAX_PATH];
GetModuleFileName(NULL,szFilePath,MAX_PATH); //获得当前程序目录
size_t iPos = strlen(szFilePath) - strlen(strrchr(szFilePath,'//'));
strncpy(szPath,szFilePath,iPos);
strcat(szPath,"//HELP.CHM");
HtmlHelp(NULL,szPath,HH_DISPLAY_TOPIC,NULL);


更多关于HtmlHelp函数的使用可以参照HTML Help API Reference

  • 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下加入代码编译软件即可实现热点敏感帮助
©️2022 CSDN 皮肤主题:大白 设计师:CSDN官方博客 返回首页

打赏作者

AFXAPI

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值