杨 伦--单 延 明--童 恒 建
---- 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 中 相 应 的 说 明。
---- 最