BCB6Delphi7下完美调用CHM帮助

在BCB6（Borland C++ Builder 6）与Delphi7环境下完美调用CHM帮助文件，是一项提升应用程序用户体验的重要技术。本文将详细解析如何在这些开发环境中实现对CHM格式帮助文档的调用，包括所需工具、步骤及代码示例。 ### 一、工具准备 确保安装了Microsoft的HtmlHelp Workshop，这是创建和编辑CHM文件的官方工具。下载地址为： [Microsoft HTML Help](http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp) HtmlHelp Workshop提供了强大的功能，不仅用于创建CHM文件，还支持对HTML文档的预览和编辑。此外，Microsoft提供了丰富的文档资料，如HtmlHelp API、HTML Workshop的使用教程以及API函数示例等，这些资料位于MSDN的“htmlhelp”关键字搜索结果中。 ### 二、CHM文件的制作 1. **HTML页面编写**：CHM文件实质上是由多个HTML页面压缩而成的，每个页面代表一个帮助主题。例如，有四个HTML文件（1001.htm、1002.htm、1003.htm、1004.htm），分别对应不同的帮助主题。 2. **定义宏**：为了方便引用，可以定义宏将HTML文件名与宏名关联起来，如： ``` #define 第一 1001 #define 第二 1002 #define 第三 1003 #define 第四 1004 ``` 3. **使用HTMLHelp Workshop**：在项目设置中，添加HTML文件，并在“HtmlHelp API Information”中设置Alias，将宏与HTML文件关联起来。同时，在“Map Numbers”中选择包含宏定义的头文件，确保调用时能够正确识别。 ### 三、在BCB6/Delphi7中调用CHM帮助 BCB6/Delphi7默认并不支持直接调用CHM帮助，需要通过注册hhctrl.ocx控件来实现。此控件提供HtmlHelp API，用于调用CHM文件。可以通过Borland提供的implib.exe工具生成静态库hhctrl.lib，以便在程序中使用。 #### 调用CHM的帮助步骤： 1. **注册hhctrl.ocx**：如果系统未自动注册，需手动注册以启用HtmlHelp API。 2. **调用WM_HELP消息**：VCL框架中默认支持调用WM_HELP消息，当用户按下F1键时，系统会查找当前窗口的HelpContext值，并调用对应的帮助文件。对于CHM文件，需要将HelpContext值与CHM文件中的ID对应。 ### 四、代码示例 在MainFormUnit.h中，可以通过以下方式定义和调用帮助： ```cpp TMainForm = class(TForm) private { HelpContext: Integer; } public procedure HelpButtonClick(Sender: TObject); end; procedure TMainForm.HelpButtonClick(Sender: TObject); begin HtmlHelp(Handle, 'yourhelpfile.chm', HH_DISPLAY_TOPIC, HelpContext); end; ``` 其中`HtmlHelp`函数是核心调用函数，`Handle`是当前窗体的句柄，`yourhelpfile.chm`是CHM文件路径，`HH_DISPLAY_TOPIC`是显示主题的标志，而`HelpContext`则是CHM文件中的帮助主题ID。 通过以上步骤，可以实现在BCB6/Delphi7中完美调用CHM帮助文件，极大地提高了应用程序的用户友好性和可维护性。