七、允许全文搜索(Full Text
Search)的HTML帮助
在上一节学的 Windows 样式中讲到
Navigation Pane 属性页的时候打住了,这一节将详细详细是如何为 HTML
帮助加上全文搜索功能的。
Navigation Pane
属性页的下方,有一个叫做“Search
Tab”的复选框,我们要做的第一步就是选中它,如下图(以 1.3
版本为例,1.1 版本相似):
第一步完成后,点击“确定”按钮以确认当前的设置。由于选中了
Search Tab 复选框,这里会打开一个“Resolve window
definition”向导。在该向导的第二步我们需要选中“Search
Tab”和“Compile full-text
Information”两个复选框,如下图所示:
然后一直往下,直到完成。设置就到此结束,然后就该编译了。由于编译过程中需要生成全文搜索信息,也就是字典,常常需要花很长一段时间,尤其是对于内容比较多的帮助文件。对于这种情况,有点象是死机,不过请你耐心的等一等,这的确是一个非常庞大的计算。
八、上下文相关(Context-Sensitive)的HTML帮助
我们的帮助文件已经基本完成了,美中不足的是这个 HTML
帮助还不能提供“上下文相关”的帮助。对于一个程序,虽有帮助文件却不支持上下文相关的帮助,无疑是一大缺憾。下面让我们一起来填补这一点不足。
首先,我们要给每个主题规定一个 ID
号,并且将不同的ID号定义成不同的常量。注意,ID
号和与之对应的常量都是唯一的!我们可以通过 C/C++
语言头文件(.H)做到这一点,在C/C++语言头文件中用 #define
语句定义常量,如:
#define IDH_LEARN_COVER 1
然后,我们还要将帮助文件的各主题映射到不同的常量:
选取“Project”标签,点击“HtmlHelp API
information”按钮,打开“HtmlHelp API
information”对话框;在第二个表页“Alias”中点击“Add”按钮,打开“Alias”对话框,如下图;第一栏中输入ID常量,如上例中的
IDH_LEARN_COVER,在第二栏中选择该ID对应的帮助主题,第三栏是备注内容,对生成的帮助文件没有影响,可以不填;点击“OK”按钮,如此便添加了一条映射信息,重复操作可以添加多条。
<