为Win95下的应用程序制作联机帮助系统

Author: 丁长霞、阎 慧 Date: 1998年 第15期 12版

  Windows 95操作系统提供了对联机帮助系统良好的支持,它界面友好,便于查看和阅读,并支持声音、图像和动画等多媒体效果。本文简要介绍如何为自己的应用程序制作一个联机帮助系统。
#1  一、制作一个HLP帮助文件
  以下介绍每一步骤:
#1  1.编辑RTF主题文件
  (1)首先要选择一个支持RTF文档格式的文字处理软件,如中文WORD等。
  (2)在编辑器中按用户显示信息的内容进行分类,形成多个标题,各标题间要硬性分页。
  (3)根据信息组织的要求,为每一标题添加相应的控制代码,控制代码如^151201a^。
  特别要指出,Windows95提供对多媒体特性的支持,包括图像、图形、声音和视频动画,其实现只需在RTF文档中将要显示多媒体信息的标题中加入相应的控制代码。
  例如:利用mci(媒体控制接口)指令完成视频动画、声音的多媒体嵌入。
  {mci}语法:
  {mci[-left|-right][options]filename}
  如:{mci play,demo.avi}或{mci play,welcome.wav}
  则在相应的标题打开后自动播放demo视频文件或welcome声音文件。
#1  2.编辑HPJ项目文件
  HPJ项目文件用于提供给帮助文件编辑器所必要的信息,使编译程序按控制代码将RTF主题文件生成帮助文件。
  项目文件由规定节构成,有其特定的语法和含义,一般包括如下节:[FILES],[OPTIONS],[BUILDTAGS],[MAP],[ALIAS],[BITMAP],[CONFIG]等。其中:
  [FILES]是必选的,用于指明帮助项目文件所包括的主题文件名。
  [OPTIONS]包括字体、大小、目录、题目等多种控制。
  [BUILDTAGS]建立合法标志。
  [MAP]上下文字符串与上下文号之间的映像。
  [ALIAS]用于上下文字符串的别名。
  [BITMAP]建立位图映像文件。
  [CONFIG]HELP文件的配置。
#1  3.编译项目文件
  调用HC31.EXE(在Borland C++、Visual Basic等软件目录下可找到)对项目文件进行编译:
  C:\HC31 MYFILE.HPJ↙
  如果编译成功,则生成MYFILE.HLP帮助文件,否则给出出错信息。
#1  二、在自己的应用程序中调用帮助文件
  如何在自己的应用程序中加入联机帮助文件呢?有如下两种方法:
#1  1.利用WINHELP.EXE程序
  利用Windows95提供的WINHELP.EXE程序来运行生成的HLP文件,即在自己的应用程序中利用加载可执行文件的方式运行即可。
  如:WinExec(“C:\PWIN95\WINHELP.EXE MyFILE.HLP”)
  此方法适合于各种语言编写的应用程序,只须修改相应的加载函数。
#1  2.利用应用语言工具提供的接口
  Windows95的许多编程语言均提供了这样的接口。如:
  在Visual  C++中建立一个基于支持联机帮助的Project,对其自动生成的两个RTF文档加以改造即可;
  在Visual Basic中通过对“Project”菜单中“HELP”属性进行设置以及在程序中对APP.HELPFILE进行赋值即可;
  在DELPHI中,在“Project”菜单的“Options”子菜单的“Application”页中设置帮助文件名,并在窗体的“Help”菜单的“Help Topic”菜单项的输入事件处理程序中加入如下语句:
  Application.HelpCommand(Help---Contents,0)。