TESTHELP 示例：具有工具提示和帮助的 ActiveX 控件

更新：2007 年 11 月

TESTHELP 示例说明如何使用 MFC 生成 ActiveX 控件，该控件具有自己的帮助文件，可以向用户显示帮助信息。Testhelp.ocx 还说明如何将工具提示添加到 MFC ActiveX 控件。

安全说明：
提供该示例代码是为了阐释一个概念，并不代表着最安全的编码实践，因此不应在应用程序或网站中使用该示例代码。对于超出本示例代码的预期用途以外的使用所造成的偶然或继发性损失，Microsoft 不承担任何责任。

获取示例和安装示例的说明：

在 Visual Studio 的“帮助”菜单上，单击“示例”。

有关更多信息，请参见定位示例文件。
示例的最新版本和完整列表可以从 Visual Studio 2008 Samples page（Visual Studio 2008 示例页面）联机获取。
还可以在计算机的硬盘上查找示例。默认情况下，示例和自述文件将复制到 \Program Files\Visual Studio 9.0\Samples\ 下的文件夹中。对于 Visual Studio 速成版，所有示例都位于联机位置。

生成并运行示例

生成 TESTHELP 示例后，将能够在任何 ActiveX 容器应用程序中使用它。有关如何访问测试容器的信息，请参见用测试容器测试属性和事件。将 TESTHELP 控件包含在容器项目中并运行该项目。通过打开容器的属性对话框，可以设置 TESTHELP 控件的属性。

此示例还包含了帮助项目文件和帮助项目的所有源文件。

从“Start”（开始）菜单中单击 Help Workshop。
打开 Testhelp.hpj。Help Workshop 显示一个将该文件转换为 .hhp 文件的向导。运行此向导，命名该文件并接受更改。
在“File”（文件）菜单上单击“Compile”（编译）。在“Create a compiled file”（创建编译文件）对话框中，指示希望用来存储已编译文件的位置，然后单击“Compile”（编译）。
若要查看已编译文件，请单击“View”（视图）菜单上的“Compiled Help File”（已编译的帮助文件）。

TESTHELP 说明如何：

Type of Help to Use（要使用的帮助类型）
当 TESTHELP 控件具有键盘焦点而且用户按 F1 键时，此属性确定如何使用帮助。弹出窗口中的“帮助”表示：如果用户在 TESTHELP 控件在容器中运行并具有键盘焦点时按 F1 键，将显示一个弹出窗口，其中包含 Testhelp.hlp 帮助文件中的“这是什么？”主题。“显示整个帮助文件”表示：如果用户在 TESTHELP 控件在容器中运行并具有键盘焦点时按 F1 键，将出现整个 Windows 帮助程序，并显示 Testhelp.hlp 文件的内容主题。
Use Control's Help File（使用控件的帮助文件）
选中此框时，如果用户在容器中运行并具有键盘焦点按 F1 键，将以“要使用的帮助类型”属性所确定的形式显示帮助。
Use ToolTip for this Control（使用此控件的“工具提示”）
选中此框时，如果控件在容器中运行，而且鼠标光标移入并停在控件的窗口中，工具提示将显示在控件窗口的上方。显示的文本由“工具提示标题”属性确定。
Tooltip Caption（工具提示标题）
这是在用户选择显示工具提示时工具提示中显示的文本。
- Name1 显示在控件顶部的名称。
- Name2 显示在控件中部的名称。
- Name3 显示在控件底部的名称。

允许用户选择用于绘制此控件的颜色。

允许用户指定控件上的文本所使用的字体。

说明：
某些示例（如此示例）尚未经过修改以反映 Visual C++ 向导、库和编译器中所做的更改，但仍演示了如何完成所需的任务。

TESTHELP 示例说明下列类和关键字：

CToolTipCtrl；COleControl::OnDraw；COleControl::OnResetState；COlePropertyPage::OnHelp

说明：
某些示例（如此示例）尚未经过修改以反映 Visual C++ 向导、库和编译器中所做的更改，但仍演示了如何完成所需的任务。