在VB应用程序中加入帮助文件的三种方法

刘强
1997-01-01

　　本文介绍了笔者在进行Ｗｉｎｄｏｗｓ应用程序开发中实现Ｗｉｎｄｏｗｓ联机帮助的三种方法（假设系统已经生成帮助文件＊．ＨＬＰ）。
　　一、直接在程序组中加入帮助图标。Ｗｉｎｄｏｗｓ的帮助文件＊ＨＬＰ在Ｗｉｎｄｏｗｓ环境下能够利用Ｗｉｎｈｅｌｐ．ｅｘｅ直接打开，所以我们在使用ＶＢ的安装向导Ｓｅｔｕｐ　Ｗｉｚａｒｄ或使用安装工具Ｓｅｔｕｐ　Ｔｏｏｌｋｉｔ时，能够自动生成程序组，在Ｗｉｎｄｏｗｓ程序组中建立帮助图标，双击此图标就可自动启动Ｗｉｎｄｏｗｓ的联机帮助系统，其原理即为“Ｗｉｎｈｅｌｐ．ｅｘｅ　＊．ｈｌｐ”这样一个命令行。
　　二、使用通用对话框Ｃｏｍｍａｎｄ　Ｄｉａｌｏｇ　Ｂｏｘ。通用对话框通过设置其属性Ａｃｔｉｏｎ可以创建六种标准对话框，分别为Ｏｐｅｎ、Ｓａｖｅ　Ａｓ、Ｃｏｌｏｒ、Ｆｏｎｔ、Ｐｒｉｎｔｅｒ、Ｈｅｌｐ。当Ａｃｔｉｏｎ属性值设为６时，就得到标准的Ｈｅｌｐ窗口显示。其主要属性有：
　　ＨｅｌｐＣｏｍｍａｎｄ：用于指定Ｈｅｌｐ帮助类型，即帮助信息命令。可以用ＨＥＬＰ系统的常数ＨＥＬＰ＿ＫＥＹ来给此项赋值，则帮助窗口就显示ＨＥＬＰ的Ｋｅｙｗｏｒｄ关键字指定的内容帮助。
　　Ｈｅｌｐｆｉｌｅ：用来指定帮助文件的路径及文件名。
　　ＨｅｌｐＫｅｙ：用来指定帮助信息的内容。
　　ＨｅｌｐＣｏｎｔｅｘｔ：帮助文件上下文为ＨｅｌｐＴｏｐｉｃ指定上下文句柄。
　　在程序设定了上述属性后，不要忘了加上“ＡＣＴＩＯＮ＝６”这一行。
　　三、调用Ｗｉｎｄｏｗｓ的应用程序接口ＡＰＩ。Ｗｉｎｄｏｗｓ的ＡＰＩ函数ＷｉｎＨｅｌｐ就是在Ｗｉｎｄｏｗｓ应用程序中加入帮助文件的函数。在ＶＢ中使用Ｗｉｎｄｏｗｓ的ＡＰＩ函数，必须在全局变量中进行声明：
　　Ｄｅｃｌａｒｅ　Ｓｕｂ　ＷｉｎＨｅｌｐ　Ｌｉｂ　＂Ｕｓｅｒ＂（ＢｙＶａｌ　ｈＷｎｄ　Ａｓ　Ｉｎｔｅｇｅｒ，ＢｙＶａｌ　ｌｐＨｅｌｐＦｉｌｅ　Ａｓ　Ｓｔｒｉｎｇ，ＢｙＶａｌ　ｗＣｏｍｍａｎｄ　Ａｓ　Ｉｎｔｅｇｅｒ，ＢｙＶａｌ　ｄｗＤａｔａ　Ａｓ　Ｌｏｎｇ）
　　同时也必须对所使用到的Ｈｅｌｐ常量作一声明：
　　Ｇｌｏｂａｌ　Ｃｏｎｓｔ　ＨＥＬＰ＿ＣＯＮＴＥＸＴ＝＆Ｈ１＇Ｄｉｓｐｌａｙ　ｔｏｐｉｃ　ｉｎ　ｕｌＴｏｐｉｃ
　　Ｇｌｏｂａｌ　Ｃｏｎｓｔ　ＨＥＬＰ＿ＱＵＩＴ＝＆Ｈ２＇Ｔｅｒｍｉｎａｔｅ　ｈｅｌｐ
　　Ｇｌｏｂａｌ　Ｃｏｎｓｔ　ＨＥＬＰ＿ＩＮＤＥＸ＝＆Ｈ３＇Ｄｉｓｐｌａｙ　ｉｎｄｅｘ
　　Ｇｌｏｂａｌ　Ｃｏｎｓｔ　ＨＥＬＰ＿ＫＥＹ＝＆Ｈ１０１
　　Ｇｌｏｂａｌ　Ｃｏｎｓｔ　ＨＥＬＰ＿ＣＯＭＭＡＮＤ＝＆Ｈ１０２
　　然后就可以在程序中象使用Ｖｉｓｕａｌ　Ｂａｓｉｃ自带的函数一样使用Ｗｉｎｄｏｗｓ的ＷｉｎＨｅｌｐ函数了。如下例就可以在应用程序中调用Ｗｉｎｄｏｗｓ的ＨＥＬＰ帮助系统。
　　ＷｉｎＨｅｌｐ　ｆｒｍｍａｉｎ．ｈＷｎｄ，＂ｄ：＼ｖｂ３０＼ｊｂｚｘ．ｈｌｐ＂，ＨＥＬＰ＿ＣＯＮＴＥＸＴ，ＨＥＬＰ＿ＣＯＮＴＥＮＴＳ

 