在VC开发中,当我们新建一个应用程序工程时,如果在第四页中选择上下文敏感帮助(Context-sensitive Help)(缺省情况下并没有选择),则应用程序建立以后,会产生一个HLP目录。缺省情况下,系统的帮助文件是winhelp格式的。后缀为*.HLP。其中有一个资源索引文件,后缀为*.hm。这是相应上下文敏感帮助的应用程序资源的索引信息。另外还有微软帮助文件制作工具winhelp。后缀为*.hpj。由于现在*.hlp格式的帮助有些过时,*.chm格式的帮助文件已经成为主流。本文给出作者实际经历的制作过程的主要步骤。
将hlp格式的帮助改为chm帮助的步骤如下:
1.首先是要安装一个叫做HTML help workshop的工具。
2.使用该工具生成一个后缀为*.hhp的帮助文件。
3.新建一个VC头文件*.h,复制*.hm中的所有内容。在所有的资源定义前加上“#define”。要注意的是:#define和后面的资源号之间有且只能有一个空格!否则敏感帮助将无效!
4.将所有帮助信息形成HTML文件。
5.所有的HTML文件必须放置在与*.hhp文件的同级目录下的HTML子目录中,否则编译出错。
6.打开*.hhp文件,在Project属性页中,为每一个上下文资源号和所对应的HTML文件建立映射。即点击HTMLhelp API information工具,建立映射关系。也可直接使用文本方式打开*.hhp后手工写入。
7.在Contents属性页中输入帮助文件的目录结构,可以为每个节点与HTML文件建立连接。
8.在Index属性页中输入查询条目,每个条目也可以和HTML文件建立连接。
9.保存并编译后,即可生成*.chm文件
10.在应用程序的APP文件的WinHelp响应处理中,使用HtmlHelp函数调用*.chm文件。
11.在应用系统中,当光标停留在某个对象(对话框或者菜单项)时,按下F1将直接弹出对该对象的帮助信息。