MFC与HtmlHelp集成

最新推荐文章于 2021-06-05 02:34:45 发布

yejuncai

最新推荐文章于 2021-06-05 02:34:45 发布

阅读量446

点赞数

本文介绍如何在MFC应用程序中集成HtmlHelp帮助系统，包括命令帮助和上下文相关帮助的实现方法。

MFC与HtmlHelp帮助系统的集成

发布者：韩永生　姚峥发布时间：2005-7-1 9:55:00

一、前言

帮助系统对于一个成功的软件来说，是必不可少的。一个好的帮助系统可以使用户在软件使用过程中能够迅速掌握软件的操作、使用方法。Windows平台的帮助系统主要包括WinHelp标准和HtmlHelp标准两种。WinHelp标准是基于RTF格式文件的帮助系统，Visual C++ 6.0集成了这种帮助系统；HtmlHelp标准是一种基于Html文件的帮助系统，由于HtmlHelp帮助系统具有直观、简洁，支持多媒体和ActiveX技术等优点，目前，HtmlHelp帮助系统已经成为Windows平台实际的帮助标准。

HtmlHelp帮助系统可以采用Microsoft提供的HtmlHelp Workshop工具进行编写，也可以采用其他一些工具。对于采用MFC编写的软件，由于Visual C++向导框架中不支持HtmlHelp帮助系统，因此，要实现MFC与HtmlHelp帮助系统的集成，必须采用一定的方法。

本文重点讨论MFC与HtmlHelp帮助系统的集成，对于HtmlHelp帮助文件的编写，请参阅其他资料。

二、HtmlHelp帮助系统接口

正确安装HtmlHelp Workshop后，就可以通过调用HtmlHelp.lib中提供的API函数，将帮助系统集成进应用程序中。其中，最重要的接口函数为：

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

参数hwndCaller为调用HtmlHelp（）的窗口句柄，pszFile为文件、URL或是经过编译的帮助文件的路径，uCommand指定了要执行的动作，dwData为uCommand所需要的参数。

对于编程人员来说，系统帮助可以分为命令帮助（响应WM_COMMAND消息）和上下文相关帮助（响应WM_CONTEXT_HELP消息）。对于用户来说，帮助系统的表现形式可以分为在帮助框架窗体中查看帮助和动态弹出窗口帮助两种形式。

三、工程实现

(1) 建立VC++工程

利用MFC建立一个单文档工程框架，注意在向导第4步，选择Context-sensitive Help选项。为了实现HtmlHelp API函数的调用，必须将HtmlHelp.h和HtmlHelp.lib加入工程中。最简单的方法就是点击VC的Project菜单下的Add To Project->Files菜单项，启动文件对话框，选择HtmlHelp.h和HtmlHelp.lib文件，然后点击OK按钮。HtmlHelp.h和HtmlHelp.lib文件可在HtmlHelp Workshop的安装目录下找到。

然后在所建工程的Stdafx.h中，加入＃include <htmlhelp.h>行。

(2) 实现命令帮助

命令帮助即用户通过点击菜单命令启动系统帮助。这种帮助的实现比较简单。通过资源管理器，添加三个菜单项，分别为帮助主题（ID_DEFAULT_HELP）、搜索（ID_HELP_FINDER）和索引（ID_HELP_INDEX）。利用ClassWizard在CMainFrame类中添加这三个菜单项的处理函数。OnDefaultHelp(),OnHelpFinder()和OnHelpIndex()。

void CMainFrame::OnDefaultHelp()

{

HtmlHelp(GetSafeHwnd(),"htmlhelpapp.chm",HH_DISPLAY_TOC,0);

}

用户通过点击帮助主题菜单后，将弹出帮助框架窗口，其中左侧浏览窗口处于“目录”页面。

void CMainFrame::OnHelpFinder()

{

HH_FTS_QUERY q;

q.cbStruct = sizeof(HH_FTS_QUERY) ;

q.fUniCodeStrings = FALSE ;

q.pszSearchQuery = "";

q.iProximity = HH_FTS_DEFAULT_PROXIMITY ;