杨 伦--单 延 明--童 恒 建
---- HTML Help Workshop 是Microsoft 比 较 新 的 开 发 工 具( 以 往 是WinHelp)， 只 在VB 6.0 和VC 6.0 以 后 的 版本中支持，在其他开发 工 具 中 怎 样 使 用 未 见 报 道。 在VC 6.0 中 也 没 有 说 明 怎 样 设 计 菜 单 上 下 文 敏 感 帮 助。 本 文 把 我 们 的 经 验 介 绍 给 大 家, 相 信 大 家 只 要 使 用 就 会 喜 欢。
一、 在 应 用 程 序 中 包 含HTML Help 支 持 文 件
---- 1. 在 项 目 中 包 含htmlhelp.lib 库 文 件
---- （1） 在Visual C++ 的 菜 单 栏 中， 选 择"Project"*"Settings" 命 令， 弹 出"Settings" 对 话 框。
---- （2） 在"Settings" 对 话 框 中， 选 择"Link" 选 项 卡， 然 后 在"category" 组 合 框 中 选 择"Input"。
---- （3） 在"Additional library path" 编 辑 框 中， 指 定htmlhelp.lib 文 件 所 在 的 路 径。
---- 2. 在 项 目 中 包 含htmlhelp.h 头 文 件
---- （1） 打 开"Settings" 对 话 框。
---- （2） 在"Settings" 对 话 框 中， 选 择"C/C++" 选 项 卡， 然 后 在"category" 组 合 框 中 选 择"Preprocessor"。
---- （3） 在"Additional include directories" 编 辑 框 中， 指 定htmlhelp.h 文 件 所 在 的 路 径。
---- 3. 在 项 目 中 加 入htmlhelp.lib 库 文 件
---- （1） 打 开"Settings" 对 话 框。
---- （2） 在"Settings" 对 话 框 中， 选 择"Link" 选 项 卡， 然 后 在"category" 组 合 框 中 选 择"General"。
---- （3） 在"Object"*"libraries module" 编 辑 框 中， 加 入htmlhelp.lib 库 文 件。
---- 4. 在 项 目 的stdafx.h 文 件 中 插 入 一 命 令 行
---- 插 入 的 命 令 行 为：
#include < htmlhelp.h >
---- 注: 当 使 用AppWizard 创 建 一 个MFC(.exe) 项 目 时， 在 第4 步 中 不 要 选 择 上 下 文 敏 感 帮 助(Context-sensitive help) 校 验 框。
二、 显 示 帮 助
---- 只 要 在 您 想 显 示 的 消 息 处 理( 菜 单 或 按 钮) 函 数 中 调 用 这 个 函 数 即 可：HtmlHelp(NULL, "MsiHtml0716.chm::/welcome.htm", HH_DISPLAY_TOPIC, 0)， 其"MsiHtml0716.chm" 是 编 译 后 的 帮 助 文 件，"welcome.htm" 是 帮 助 系 统 的 主 页。
三、 实 现 对 话 框 上 下 文 敏 感 帮 助
---- 1. 在 帮 助 项 目 中 创 建 上 下 文 敏 感 帮 助 文 本 文 件
---- 格 式 如 下：
.topic IDH_CHECK1
help text for control 1(IDC_CHECK1)
.topic IDH_CHECK2
help text for control 2(IDC_CHECK2)
---- 其 中IDH_CHECK1 和IDH_CHECK2 为 对 话 框 控 件 的 帮 助 主 题ID( 主 题 号 的 别 名)。
---- 2. 创 建 一 个2 维 数 组， 映 射 控 件ID 和 帮 助 主 题 号
---- 在 对 话 框 类 的*.cpp 文 件 中, 加 入 一 个2 维 数 组， 数 组 形 式 如 下：
static DWORD myarray[] = {
IDC_CHECK1, 1,
IDC_CHECK2, 2,
IDC_CHECK3, -1,
0,0
};
---- 其 中IDC_CHECK1 是 控 件 的ID，1 是 控 件 的 帮 助 主 题 号，-1 表 示 该 控 件 没 有 帮 助， 数 组 的 最 后 一 对 是0 和0。
---- 3. 在 帮 助 项 目 中 创 建 一 个 头 文 件， 映 射 主 题 号 和 主 题ID
#define IDH_CHECK1 1
#define IDH_CHECK2 2
---- 把 头 文 件 和 文 本 文 件 添 加 到 帮 助 项 目 中, 具 体 详 见VB 中 相 应 的 说 明。
---- 最 后 的 映 射 关 系 为：
---- 控 件 的ID < --(2 维 数 组)--> 帮 助 主 题 号< -- ( 头 文 件) --> 主 题ID< --( 文 本 文 件)-- > 控 件 帮 助 正 文
---- 4. 实 现 鼠 标 右 键 触 发" 这 是 什 么 ？" 帮 助
---- 在 对 话 框 类 中 加 入WM_CONTEXTMENU 消 息 的 处 理 函 数， 形 式 如 下：
void CMyDialog::OnContextMenu
(CWnd* pWnd，CPoint point)
{
HtmlHelp(
pWnd->GetSafeHwnd()，
"my_chm.chm::/ctrlhlp.txt"，
HH_TP_HELP_CONTEXTMENU，
(DWORD)(LPVOID)myarray)；
}
F1 access to context-sensitive help means that users
will be able to press F1 when a control has focus to access help.
---- 5. 实 现F1 键 触 发 上 下 文 敏 感 帮 助
---- 在 对 话 框 类 中 加 入WM_HELPINFO 消 息 的 处 理 函 数， 形 式 如 下：
BOOL CMyDialog::OnHelpInfo(HELPINFO* pHelpInfo)
{
if (pHelpInfo- >iContextType == HELPINFO_WINDOW)
{
return HtmlHelp(
(HWND)pHelpInfo- >hItemHandle,
"my_chm.chm::/ctrlhlp.txt"，
HH_TP_HELP_WM_HELP，
(DWORD)(LPVOID)myarray)
!= NULL；
}
return TRUE；
}
---- 6. 实 现" 这 是 什 么 ？" 问 号 指 针 帮 助
---- 如 果 您 已 经 实 现F1 键 触 发 上 下 文 敏 感 帮 助， 那 么 很 容 易 实 现 问 号 指 针 帮 助。 在 对 话 框 的 扩 展 风 格 中， 选 择 上 下 文 敏 感 帮 助 校 验 框， 使 小 问 号 图 标 出 现 在 对 话 框 标 题 条 的 右 边 即 可。
四、 实 现 菜 单 上 下 文 敏 感 帮 助
---- 1. 加 入WM_MENUSELECT 消 息 处 理 函 数
---- 这 样 做 的 目 的 是 获 取 上 下 文 敏 感 菜 单 的 标 志。
void CMainFrame::OnMenuSelect
( UINT nItemID, UINT nFlags, HMENU hSysMenu )
{
TRACE("CMainFrame::OnMenuSelect: nItemID=
%d,nFlags=%d,HMENU=%d%\n",nItemID,
nFlags,hSysMenu);
//when close menu or press ESC key or press F1 key outside
// the menu , please don't not assignment
if(nFlags!=0xFFFF && hSysMenu!=0)
m_nMenuItemIDOfContextHelp=nItemID;
CFrameWnd::OnMenuSelect(nItemID, nFlags, hSysMenu);
}
---- 2. 加 入WM_HELPINFO 消 息 处 理 函 数
---- 这 样 的 目 的 是 获 取F1 的 按 键 消 息, 实 现 菜 单 上 下 文 敏 感 帮 助。
BOOL CMainFrame::OnHelpInfo
(HELPINFO* pHelpInfo)
{
TRACE("CMainFrame::OnHelpInfo---
m_nMenuItemIDOfContextHelp=
%d\n",m_nMenuItemIDOfContextHelp)；
switch(m_nMenuItemIDOfContextHelp)
{
case IDM_HtmlHelp:
HtmlHelp(NULL, "MsiHtml0716.chm::/zoom.htm",
HH_DISPLAY_TOPIC, 0);
m_nMenuItemIDOfContextHelp=0;
break;
case IDM_LOOKDLG:
HtmlHelp(NULL,"MsiHtml0716.chm::/
zoom11.htm", HH_DISPLAY_TOPIC, 0);
m_nMenuItemIDOfContextHelp=0;
break;
default:
HtmlHelp(NULL,"MsiHtml0716.chm::/
welcome.htm", HH_DISPLAY_TOPIC, 0);
}
return CMDIFrameWnd::OnHelpInfo(pHelpInfo);
}
---- 读 者 朋 友 若 对 此 感 兴 趣， 可 向 作 者（thj@cug.edu.cn） 索 要 完 整 的 源 程 序。
---- （ 作 者 地 址： 湖 北 武 汉 市 中 国 地 质 大 学 信 息 工 程 学 院 软 件 教 研 室，430000）
关键词：在VC6.0中运用新一代帮助系统