VC++MFC帮助文件的实现

很多人问起现在的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_操 作 手 册.HtmIDH_WJH_0100000000 = 用户操作手册.Content/0100000000_第一部分 系统介绍.HtmIDH_WJH_0100100000 = 用户操作手册.Content/0100100000_第一章 主要功能.HtmIDH_WJH_0100101000 = 用户操作手册.Content/0100101000_1、基本功能.HtmIDH_WJH_0100102000 = 用户操作手册.Content/0100102000_2、高级应用功能.Htm

 

编制好这两文件后，包含在HHP工程文件中，用HTML WORK SHOP进行编译就可以了。 现在网上也有很多软件可以按照WORD文档的章节自动生成上述文件，极大的方便了用户制作软件热点敏感帮助。现推荐一款制作CHM的软件：Word2CHM帮助文档制作工具，此软件自动将WORD文档按照章节转换成CHM文档，并自动生成上述两个文件。您需要做的就是按照第一节介绍的方法在VC下加入代码编译软件即可实现热点敏感帮助。