本文简要介绍如何为应用程序制作一个帮助文件。
我们需要借助的工具软件清单如下：
（1）支持Rtf格式的文字处理软件，例如 Office 中的Word。
（2）Help WorkShop。（由VC6携带安装的一个工具）
步骤1：用文字处理软件编辑你的帮助文件（*.rtf)，这个文件定义你的帮助文件中的一些主题（Topic），每个topic实际上就是用WinHelp显示的一个页面。这一部本质上就属于文字处理了，只是你需要在保存的时候选择rtf格式。需要特别掌握的是以下几点：
每个topic结束后追加一个分页符。 在每个topic的最前面可以添加以下脚注（添加的脚注请使用以下编号）：
#：你的topic的一个唯一标识符，它是必须的，也是做链接时需要用到的。
K：定义该topic的关键字，用英文分号分割；
$：定义该topic的标题，它将显示在winhelp的历史窗口，查找等地方。
制作链接时，把链接的文本用双下划线格式，然后在文本后面添加一段隐藏文本，输入要链接的topic的唯一标示符。
制作出来的rtf文档效果如下图所示： 下图显示的是帮助文件的目录，里面包含了到每个topic的链接。
下图显示的是为某个topic添加的脚注：
（2）创建一个Help项目：打开 Microsoft help workshop 软件， 点击File -> New ->选择 Help Project；
建立好项目以后，我们可以使用右侧的那些按钮去设置这个项目的一些信息，过程很简单，这里就不详细介绍了， 细节可以查阅 help workshop 的帮助文件。设置好的项目如下图所示：
（3）先把项目保存，然后我们用help workshop 创建帮助文件的内容文件（*.cnt)。 使用菜单 File->New-> 选择help Contents。然后我们添加目录（Head，一本书的图标）和Topic（文件图标），使用 MoveLeft 和 MoveRight 按钮可以修改缩进。做好的 Contents 效果如下图所示：
（4）把 contents文件保存，然后打开刚才的help Project， 在Options的 Files 标签页中填加 Contents 文件。如下图所示：
然后我们点击“ Save and compile ” 按钮编译帮助文件，编译成功以后，通过菜单 File -> Run Winhelp 可以看到我们做的帮助文件的效果如下图所示：
帮助文件基本做好了，现在我们为我们的应用程序添加对帮助的支持，首先我们在资源中打开窗口的菜单资源，在帮助菜单下添加下面几项：
帮助主题（IDM_HELPCONTENTS), 内容（IDM_HELPCONTENTS），搜索帮助（IDM_HELPSEARCH），然后我们在窗口过程中处理WM_COMMAND消息时添加对这几个菜单的处理，相关代码如下：
code_wndproc
void GetAppFolderFileName( char * buffer, char * shortFileName)
{
char * pChar = NULL;
GetModuleFileName(NULL, buffer, MAX_PATH);
pChar = strrchr(buffer, ' \\ ' );
if (pChar != NULL)
{
strcpy(pChar + 1 , shortFileName);
}
}
LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
WORD ctlId, wmEvent;
switch (message)
{
case WM_HELP: // F1
{
// 获取和程序位于同一个目录下文件的绝对路径
char buffer[MAX_PATH];
GetAppFolderFileName(buffer, " RFCARD.HLP " );
WinHelp (hWnd, buffer, HELP_CONTENTS,(DWORD) 0 );
}
break ;
case WM_COMMAND:
ctlId = LOWORD(wParam);
wmEvent = HIWORD(wParam);
switch (ctlId)
{
case IDM_HELPTOPICS: // "Help Topics..."
{
char buffer[MAX_PATH];
GetAppFolderFileName(buffer, " RFCARD.HLP " );
WinHelp (hWnd, buffer, HELP_FINDER,(DWORD) 0 );
}
break ;
case IDM_HELPCONTENTS: // "Contents"
{
char buffer[MAX_PATH];
GetAppFolderFileName(buffer, " RFCARD.HLP " );
WinHelp (hWnd, buffer, HELP_CONTENTS,(DWORD) 0 );
}
break ;
case IDM_HELPSEARCH: // "Search for Help On..."
{
char buffer[MAX_PATH];
GetAppFolderFileName(buffer, " RFCARD.HLP " );
WinHelp(hWnd, buffer, HELP_PARTIALKEY, (DWORD)(LPSTR) "" );
}
break ;
default :
return DefWindowProc(hWnd, message, wParam, lParam);
}
break ;
}
}
然后我们重新编译我们的应用程序，成功以后，可以在应用程序处于前台时按下F1键（程序将收到WM_HELP消息），或者点击帮助下面的菜单，查看效果可能如下图所示：
本文参考以下资料：
（1）崔晓阳，实例简述Hlp帮助文件的制作，《农业网络信息》2007年第9期。
（2）MSDN：ms-help://MS.VSCC.v80/MS.MSDN.v80/MS.WIN32COM.v10.en/dnwui/html/msdn_generic.htm
Robert B. Hess, Generic: Anatomy of a Simple Win32 Application, Windows User Interface Technical Articles, October 17, 1994;
