融海咨询informix_4gl教材第九章创建帮助文件：mkmessage工具.docVIP

第九章创建帮助文件：mkmessage工具本章介绍用mkmessage工具创建帮助文件的概念和方法。mkmessage工具mkmessage是一个工具，用于为应用创建用户联机帮助信息。什么是工具？在INFORMIX-4GL中，工具必须在操作系统中运行，不能从INFORMIX-4GL的编程环境中执行。mkmessage是把帮助信息的正文文件编译到一个文件中，使它可被INFORMIX-4GL程序调用的工具。怎么使用mkmessage首先要创建帮助信息的文本文件，这个文件可用任意系统编辑器编辑产生。上面说明了一个叫custhelp.msg的文件信息。在命令行(以$开头)，这个文件被编译为custhelp.ex。这是INFORMIX-4GL可识别的帮助文件格式。帮助文件帮助文件是包含可被MENU、INPUT和PROMPT语句使用的消息号的文本文件。如上所示的帮助文件，是在用户菜单上显示的菜单选项的帮助信息。创建一个帮助文件帮助文件由一系列由行分隔的一个带信息编号的帮助信息组成，帮助文件必须是这种格式。用下面指令和规则创建帮助文件：l l 用文本编辑器创建文件存储文本信息，可以为帮助文件起任意的文件名。为了便于识别，最好以.msg后缀命名文件。l l 用如上图的格式输入帮助文件，要确保在单独的行输入点(.)和信息编号，再在其后输入帮助信息，信息编号不一定连续，但必须唯一。l l 当输入完帮助信息，保存这个文件。l l 运行mkmessage工具，其命令格式见下页。编译帮助文件同INFORMIX-4GL中的格式和程序不同，它不能在INFORMIX-4GL编程环境中编译帮助文件，相反，必须用mkmessage工具来编译它。可以如上图一样输入mkmessage命令，其中filename1是帮助信息文本文件名，filename2是给INFORMIX-4GL使用的编译文件名。命名编译文件可以给filename2命名任意的文件名，为了便于识别编译文件和帮助文件的联系，可以起和文本文件filename1相似的文件名。在上例中，文本文件custhelp.msg转化成了INFORMIX-4GL可使用的custhelp.ex文件。警告不要给文本文件和编译文件起同样的名字，若两者名字相同，则mkmessage会用编译文件覆盖文本文件，这样就无法再对帮助文件进行修改或增加了。指定帮助文件和帮助键OPTIONS语句为程序提供了设置帮助的两个选项。步骤如下：l l HELP FILE “filename”说明帮助文件的路径及名称，若”filename”不在当前路径下，则要在HELP FILE保留字后写明编译后的帮助文件的全路径。l l HELP KEY kelp-key，其中help-key是一个功能键或CONTROL键。要用功能键作帮助键，输入Fn，其中n是功能键号。CONTROL键的输入格式是CONTROL-x，其中x是同CONTROL键一同按下的字母键。缺省的帮助键是CONTROL-w，不能用下面的键做为OPTIONS语句中的HELP KEY子句：INTERRUPTESCAPECONTROL-ACONTROL-DCONTROL-HCONTROL-LCONTROL-RCONTROL-X注意依据不同的操作系统，可能还有别的不能在HELP KEY子句中使用的键。MENU语句中的帮助在OPTIONS语句中指定帮助文件后，这个帮助文件中的信息就可以使用了。在MENU语句中，菜单上的每个命令都可以关联帮助信息。如上图中例子，如果用户按了Query选项的帮助键，帮助文件中与2号有关的信息将自动显示在帮助菜单区域。注意用户不按帮助键，帮助信息是不会自动显示的，而且用户按下帮制键后只有与帮助号相关的内容显示。PROMPT语句中的帮助可以用HELP#符号给PROMPT语句加入帮助信息。如上图例子中，在用户响应询问前，如果按了帮助键，与100号相关的信息将显示在帮助菜单区域中。帮助菜单当用户请求帮助时，就会从帮助文件中读取INFORMIX-4GL程