在VC6.0中使用新一代帮助系统

【C语言编程】 2017-08-16本文已影响
杨 伦--单 延 明--童 恒 建

---- 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)

本站所有资源均来自于秒教学习网蜘蛛爬取结果,如您发现侵权、违法、存在不和谐内容,告知本站一律删除

本站不以盈利为目的,全站资源仅供学习爱好使用。本站站长邮箱:3569622@qq.com

备案号:

©秒教学习网  2016-2019版权所有     站点地图

回到顶部