如何用 Win32 SDK 编程创建 Tri-pane HTML Help 窗口

核心提示：HTML Help 使用户能在一个帮助窗口中使用工具棒、查看目录和帮助主题，目前，如何用 Win32 SDK 编程创建 Tri-pane HTML Help 窗口，有两种方法创建 Tri-pane 类型的 HTML Help 窗口：使用 HTML Help Workshop 创建窗口 使用 HTML Help API

HTML Help 使用户能在一个帮助窗口中使用工具棒、查看目录和帮助主题。目前，有两种方法创建 Tri-pane 类型的 HTML Help 窗口：

• 使用 HTML Help Workshop 创建窗口
• 使用 HTML Help API 编程创建窗口

本文将介绍如何使用这两种方法创建Tri-pane HTML Help 窗口。

使用预定义窗口

在 HTML Help Workshop环境中很容易创建和修改工程的窗口定义，有关窗口定义的其它信息，请参考微软知识库文章：Q189084 HOWTO: Create a Tri-pane Window with HTML Help Workshop

本文假设在你的应用程序开发工具为 Visual C++，那么要在自己的程序中使用HTML Help帮助，必须借助于HTML Help提供的 API 函数；要调用这些 API 函数，就必须包含 htmlhelp.h 文件，并且将库文件 hhctrl.lib 或者 htmlhelp.lib 链接到自己的程序代码中。只要你安装了HTML Help Workshop环境，这些文件存放在 HTML Help Workshop下的 \Include 和 \Lib 目录中。

在下面的示范代码中，sample.chm是一个编译好的HTML Help帮助文件，其中有一个叫“ mywindow”的窗口定义，下面的代码示范了如何在一个 MFC 程序中调用 HTML Help API函数：

// CMainFrame message handler
　 void CMainFrame::OnHelp()
　 {
　　　// display the topic "intro.htm" in the window defined
　　　// in the HTML Help Workshop
　　　HtmlHelp(m_hWnd,"sample.chm::\\intro.htm>mywindow",
　　　　 HH_DISPLAY_TOPIC,0);
　 }　　　

使用 HTML Help API

为了创建 three-pane 窗口, 必须首先创建和填写HH_WINTYPE结构。 HH_WINTYPE结构在HtmlHelp.h中定义,详细说明参见HTML Help Workshop文档。 以下是一个例子: