在Viusal C++ 6中使用 HTML Help《转》

在Visual C++ 6中调用HTML Help没有现成的函数，需要调用HtmlHelp()这个API函数。而在调用这个函数之前，还需要在你的工程中加上HtmlHelp的库和头文件：

　　1. 指定HtmlHelp.h的路径。选择菜单“Project -> Settings...”，打开“Project Settings”对话框。选中“C/C++”选项卡，选择“Category”列表框的内容为“Preprocesor”，在“Additional include directories”项中填入包含“HtmlHelp.h”这一文件的路径。这个文件你可以在你的硬盘上找，如果你安装了“HTML Help Workshop”，那么在“HTML Help Workshop”程序目录下有个“Include”目录就是。

　　2. 指定HtmlHelp.lib的路径。按照与前面类似的方法，选择“Link”选项卡，选择“Category”为“Input”，在“Additional library path”中填入包含“HtmlHelp.lib”文件的路径。同样，在“HTML Help Workshop”程序目录下的"Lib"目录就是。

　　3. 指定Lib文件。同样在“Link”选项卡中，选择“Category”为“General”，在“Object/librarie module”中填入“HtmlHelp.lib”。

　　4. 最后，将HtmlHelp.h包含在程序中。你可以选择一个合适的位置加入“#include”这一句话，但我建议你将这句话加入到“Stdafx.h”中。

　　注：以上所有内容在MSDN的“Including HTML Help Support Files in an Application”主题中均有介绍，在“搜索”选项卡中输入查找内容为“HtmlHelp”即可找到该主题。

　　最后是大家都关心的问题，如何在程序中调用HTML Help。

　　如同在Visual Basic 6中使用HTML Help一样，首先需要定位帮助文件的位置。假如我们把帮助文件(.chm)放在程序路径下，那么我们该如何去获得程序路径呢？程序大本营上是使用的API函数GetModuleFileName()，例如，我使用以下代码定位程序路径和取文件的完整路径文件名：

　　CString appPath;

　　GetModuleFileName(NULL, appPath.GetBuffer(MAX_PATH), MAX_PATH);

　　//注：使用该API函数得到的是程序文件完整路径文件名，去掉文件名后才是路径。

　　appPath.ReleaseBuffer();

　　int n = appPath.ReverseFind('\\');

　　CString helpFile;

　　helpFile = appPath.Left(n);

　　TCHAR c = helpFile.GetAt(n - 1);

　　if(c == '\\')

　　 　helpFile += "HtmlHelp.chm";

　　else

　　　　helpFile += "\\HtmlHelp.chm";

通过HtmlHelp调用帮助文件(.chm)的程序代码如下：

　　HtmlHelp(NULL, (LPCSTR)helpFile, HH_DISPLAY_TOPIC, 0);

　　//直接打开帮助文件的默认主题。

　　或

　　HtmlHelp(NULL, (LPCSTR)helpFile, HH_HELP_CONTEXT, 1);

　　//打开其中一个主题，实现上下文相关的帮助调用。

　　

当然，在合适的位置提示相关的主题内容很重要，我程序中使用了PreTranslateMessage(MSG* pMsg) 来捕捉光标位置。

switch (pMsg->message)
{
   case WM_KEYDOWN:
   case WM_SYSKEYDOWN:
   switch (pMsg->wParam)
   {
    case VK_F1:
    DisplayMainDlgHelpInfo();//这个函数是自己写的一个处理函数，可以根据具体情况具体编写
     break;

    default:
     break;

}   
}
return    CDialog::PreTranslateMessage(pMsg)

如此，在Visual C++ 6中，你也能调用HtmlHelp了。这次可是用的API函数，也就是说，略为改动你就可以用于……

知识扩展:

　　

程序调用

调用缺省主题帮助

Call HtmlHelp(hwnd,
App.HelpFile,
HH_DISPLAY_TOPIC,
ByVal "Default.htm")

 

此调用方式用于没有上下文ID号的情形，dwData可指定一个在CHM文件内的缺省htm文件，也可取NULL，这是HtmlHelp
API最基本的一种用法。

 

调用关键字帮助

 

Call HtmlHelp(hwnd,
App.HelpFile,
HH_DISPLAY_INDEX,
(DWORD)"关键字"))

 

此调用方式中dwData取索引文件（.hhk）中存在的关键字。

调用上下文敏感帮助

Call HtmlHelp(hwnd,
App.HelpFile,
HH_HELP_CONTEXT, 1000)

 

此调用方式用于含有映射信息的CHM文件, dwData取映射表中存在的ID号。

调用全文搜索帮助

Dim Query As HH_FTS_QUERY
Call HtmlHelp(hwnd,
App.HelpFile,
HH_DISPLAY_SEARCH,
(DWORD)& Query)

 

DwData参数指定一个指向HH_FTS_QUERY结构的指针。

 

调用弹出式帮助

 

Dim Popup As HH_POPUP
Call HtmlHelp(hwnd,
NULL,
HH_DISPLAY_TEXT_POPUP,
(DWORD)&Popup)

 

PszFile通常取NULL，也可以指定一个CHM和一个在该CHM文件中的TEXT文件，DwData用于指定一个指向HH_POPUP结构的指针。

 

指定显示窗体形式

由于显示帮助文件的缺省窗体是在编译该CHM文件时的窗体，因此为了更好地控制帮助文件的显示，在制作CHM文件时，可以自定义一个窗体形式。在程序中可以通过两种方法来调用自定义窗体。

1.当uCommand 为HH_DISPLAY_TOPIC或HH_HELP_CONTEXT时，在pszFile参数中用“＞”符号，其后跟上窗体名称即可。如pszFile取：
App.HelpFile & "＞ MainWin"
2.用HtmlHelp函数直接指定：
Dim WinType As HH_WINTYPE
Call HtmlHelp(hwnd,
App.HelpFile &" ＞ MainWin",
HH_SET_WIN_TYPE,
(DWORD) &WinType)

 

必须声明的是，以上叙述中使用的“Sample.CHM”、“Default.htm”、“关键字”、“1000”和“MainWin”等均属举例，应用中需要根据自己的具体情况来设置这些参数的实际值。

 

转载于:https://www.cnblogs.com/cwbo-win/articles/3387286.html