049.htm

delphi教程

face="Arial" size="3"></p>
<p>Delphi</font><font face="宋体" lang="ZH-CN" size="3">基于关键词查询</font><font
face="Arial" size="3">HELP</font><font face="宋体" lang="ZH-CN" size="3">请求。就是说，当用户在窗体设计窗口的已选部件上按</font><font
face="Arial" size="3">F1</font><font face="宋体" lang="ZH-CN" size="3">键时，</font><font
face="Arial" size="3">Delpdi</font><font face="宋体" lang="ZH-CN" size="3">将部件的名字转换成一个关键词，然后调用</font><font
face="Arial" size="3">Windows Help</font><font face="宋体" lang="ZH-CN" size="3">引擎查找那个关键词的帮助主题。关键词是</font><font
face="Arial" size="3">Windows Help</font><font face="宋体" lang="ZH-CN" size="3">系统的标准部分。实际上</font><font
size="3"> </font><font face="宋体" lang="ZH-CN" size="3">，</font><font face="Arial"
size="3">WinHelp</font><font face="宋体" lang="ZH-CN" size="3">使用</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">中的关键词产生</font><font
face="Arial" size="3">Search</font><font face="宋体" lang="ZH-CN" size="3">对话框中的列表。因为用于上下文敏感搜索中的关键词不是实际供用户读的，所以要输入关键词的替代词。</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">例如，一个查找名为</font><font
face="Arial" size="3">TSomething</font><font face="宋体" lang="ZH-CN" size="3">的部件的详细信息的用户可能打开</font><font
face="Arial" size="3">WinHelp</font><font face="宋体" lang="ZH-CN" size="3">的</font><font
face="Arial" size="3">Search</font><font face="宋体" lang="ZH-CN" size="3">对话框并输入</font><font
face="Arial" size="3">TSomething</font><font face="宋体" lang="ZH-CN" size="3">。但不会使用用于窗体设计窗口的上下文查找的替代形式</font><font
face="Arial" size="3">class-TSomething</font><font face="宋体" lang="ZH-CN" size="3">。因此，这个特殊的关键词</font><font
face="Arial" size="3">Class-TSomething</font><font face="宋体" lang="ZH-CN" size="3">对用户是不可见的，以免弄乱了搜索列表。</p>
<p>　　⑵</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">将</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">插入</font><font
face="Arial" size="3">Delphi</p>
<p>Delphi</font><font face="宋体" lang="ZH-CN" size="3">提供了创建和插入</font><font
face="Arial" size="3">Windows Help</font><font face="宋体" lang="ZH-CN" size="3">文件的工具，包括</font><font
face="Arial" size="3">Windows Help</font><font face="宋体" lang="ZH-CN" size="3">编译器</font><font
face="Arial" size="3">HC.EXE</font><font face="宋体" lang="ZH-CN" size="3">。为自定义部件建立</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件的机制与建立任何</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件没什么不同，但需要遵循一些约定以与库中其它</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">兼容。</p>
<p>　　保持兼容性的方法如下：</p>
<p>　　●</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">建立</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">增加特殊的注脚</font><font face="Arial"
size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">建立关键词文件</font><font face="Arial"
size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">插入</font><font face="Arial" size="3">Help</font><font
face="宋体" lang="ZH-CN" size="3">索引</p>
<p></font><font size="3">　</font><font face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">当你为自定义部件建立完</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">，有下列几个文件：</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">编译过的</font><font face="Arial" size="3">Help(.HLP)</font><font
face="宋体" lang="ZH-CN" size="3">文件</font><font face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">关键词</font><font
face="Arial" size="3">(.KWF)</font><font face="宋体" lang="ZH-CN" size="3">文件</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">一个或多个</font><font face="Arial" size="3">Help</font><font
face="宋体" lang="ZH-CN" size="3">源文件</font><font face="Arial" size="3">(.RTF)</p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">工程文件</font><font
face="Arial" size="3">(.HLJ)</p>
<p></font><font size="3">　</font><font face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">编译过的</font><font face="Arial"
size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件和关键词文件应当与库单元在同一目录。</p>
<p>　　①</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">建立</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">你可以使用任何的工具创建</font><font
face="Arial" size="3">Windows Help</font><font face="宋体" lang="ZH-CN" size="3">文件。</font><font
face="Arial" size="3">Delphi</font><font face="宋体" lang="ZH-CN" size="3">的多文件搜索引擎，可以包含任何数目的</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件的要素。在编译的</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件之外，你应当拥有</font><font
face="Arial" size="3">RTF</font><font face="宋体" lang="ZH-CN" size="3">源文件，这样才能生成关键词文件。</p>
<p>　　为使自定义部件的</font><font face="Arial" size="3">Help</font><font
face="宋体" lang="ZH-CN" size="3">同库中其它部件一起工作，要遵循下列约定：</p>
<p>　　●</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">每个部件有占一页的帮助</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">部件帮助页应当给出部件目的的简单描述，然后列出最终用户可用的属性、事件和方法的描述。应用开发者通过在窗体上选择部件并按</font><font
face="Arial" size="3">F1</font><font face="宋体" lang="ZH-CN" size="3">访问这一页。</p>
<p>　　部件帮助页应当有一个用于关键词搜索的“Ｋ”脚注，脚注中包含部件名。例如，</font><font
face="Arial" size="3">TMemo</font><font face="宋体" lang="ZH-CN" size="3">的关键词脚注读作</font><font
face="Arial" size="3">&quot;TMemo Component&quot;</p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">部件增加和修改的每一个属性，事件和方法应当有一页帮助</p>
<p>　　属性、事件或方法的帮助页应当指出该项用于哪个部件，显示声明语法和描述它的使用方法。</p>
<p>　　属性、事件或方法的帮助页应当有一个用于关键词搜索的“Ｋ”脚注，该脚注中包含该项的名字和种类。例如，属性</font><font
face="Arial" size="3">Top</font><font face="宋体" lang="ZH-CN" size="3">的关键词脚注为“</font><font
face="Arial" size="3">Top property</font><font face="宋体" lang="ZH-CN" size="3">”。</p>
<p>　　</font><font face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN"
size="3">文件的每一页也需要用于多文件索引搜索的特殊脚注。</p>
<p>　　②</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">增加特殊脚注</font><font
face="Arial" size="3"></p>
<p>Delphi</font><font face="宋体" lang="ZH-CN" size="3">需要特殊的搜索关键词以区别用于部件的帮助页和其它项目。你应当为每一项提供标准的关键词搜索项。但你也需要用于</font><font
face="Arial" size="3">Delphi</font><font face="宋体" lang="ZH-CN" size="3">的特殊脚注。</p>
<p>　　要为来自</font><font face="Arial" size="3">Object Inspector</font><font
face="宋体" lang="ZH-CN" size="3">窗口或代码编辑器</font><font face="Arial"
size="3">F1</font><font face="宋体" lang="ZH-CN" size="3">的搜索增加关键词，就得为</font><font
face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN" size="3">文件帮助页增加</font><font
face="Arial" size="3">&quot;B&quot;</font><font face="宋体" lang="ZH-CN" size="3">脚注。</p>
<p>　　“</font><font face="Arial" size="3">B</font><font face="宋体" lang="ZH-CN"
size="3">”脚注与用于标准</font><font face="Arial" size="3">WinHelp</font><font
face="宋体" lang="ZH-CN" size="3">关键词搜索的“</font><font face="Arial"
size="3">K</font><font face="宋体" lang="ZH-CN" size="3">”脚注很相象，但它们只用于</font><font
face="Arial" size="3">Delphi</font><font face="宋体" lang="ZH-CN" size="3">搜索引擎。下表列出怎样为每种部件帮助页建立“</font><font
face="Arial" size="3">B</font><font face="宋体" lang="ZH-CN" size="3">”脚注：</p>
<p></font><font size="3">　</font><font face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">表</font><font face="Arial" size="3">19.7
</font><font face="宋体" lang="ZH-CN" size="3">部件帮助页搜索注脚</p>
<p>　　</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">帮助页类型</font><font size="3"> </font><font
face="Arial" size="3">&quot;B&quot;</font><font face="宋体" lang="ZH-CN" size="3">脚注内容</font><font
size="3"> </font><font face="宋体" lang="ZH-CN" size="3">示</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">例</font><font size="3"> </font><font face="宋体"
lang="ZH-CN" size="3"></p>
<p>　　</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">──────────────────────────────────</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">主部件页</font><font size="3"> </font><font
face="Arial" size="3">'class_'+</font><font face="宋体" lang="ZH-CN" size="3">部件类型名</font><font
size="3"> </font><font face="Arial" size="3">class_TMemd</p>
<p></font><font face="宋体" lang="ZH-CN" size="3">一般属性或事件页</font><font
size="3"> </font><font face="Arial" size="3">'prop_'+</font><font face="宋体"
lang="ZH-CN" size="3">属性名</font><font size="3"> </font><font face="Arial" size="3">prop_WordWrap</p>
<p>'event_'+</font><font face="宋体" lang="ZH-CN" size="3">事件名</font><font
size="3"> </font><font face="Arial" size="3">event_OnChange</p>
<p></font><font face="宋体" lang="ZH-CN" size="3">部件特有的属性</font><font
size="3"> </font><font face="Arial" size="3">'prop_'+</font><font face="宋体"
lang="ZH-CN" size="3">部件类型名</font><font size="3"> </font><font face="Arial"
size="3">prop_TMemoWordWrap</p>
<p></font><font face="宋体" lang="ZH-CN" size="3">或事件页</font><font size="3"> </font><font
face="Arial" size="3">+</font><font face="宋体" lang="ZH-CN" size="3">属性名</font><font
size="3"> </font><font face="Arial" size="3"></p>
<p>'event_'+</font><font face="宋体" lang="ZH-CN" size="3">部件类型名</font><font
size="3"> </font><font face="Arial" size="3">event_TMemoOnChange</p>
<p>+</font><font face="宋体" lang="ZH-CN" size="3">事件名</p>
<p>　　</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</p>
<p>　</p>
<p>　　区别一般帮助页和部件特有的帮助页是很重要的。一般帮助页应用于所有部件上的特定属性和事件。例如</font><font
face="Arial" size="3">Left</font><font face="宋体" lang="ZH-CN" size="3">属性是所有部件中的标识。因此，它用字符串</font><font
face="Arial" size="3">Prop-Left</font><font face="宋体" lang="ZH-CN" size="3">进行搜索。而</font><font
face="Arial" size="3">Borde-style</font><font face="宋体" lang="ZH-CN" size="3">依赖于所属的部件，因此，</font><font
face="Arial" size="3">BorderStyle</font><font face="宋体" lang="ZH-CN" size="3">属性拥有自己的帮助页。例如，</font><font
face="Arial" size="3">TEdit</font><font face="宋体" lang="ZH-CN" size="3">有</font><font
face="Arial" size="3">BorderStyle</font><font face="宋体" lang="ZH-CN" size="3">属性的帮助页，搜索字符串为</font><font
face="Arial" size="3">Prop_TEditBorderStyle</font><font face="宋体" lang="ZH-CN"
size="3">。</p>
<p>　　③</font><font size="3"> </font><font face="宋体" lang="ZH-CN" size="3">建立关键词文件</p>
<p>　　建立和编译了</font><font face="Arial" size="3">Help</font><font
face="宋体" lang="ZH-CN" size="3">文件，并且增加了脚注之后，还要生成独立的关键词文件，这样</font><font
face="Arial" size="3">Delphi</font><font face="宋体" lang="ZH-CN" size="3">才能将它们插入主题搜索的索引。</p>
<p>　　从</font><font face="Arial" size="3">Help</font><font face="宋体" lang="ZH-CN"
size="3">资源文件</font><font face="Arial" size="3">RTF</font><font face="宋体"
lang="ZH-CN" size="3">创建关键词文件的方法如下：</font><font face="Arial"
size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">在</font><font face="Arial" size="3">DOS</font><font
face="宋体" lang="ZH-CN" size="3">提示行下，进入包含</font><font face="Arial"
size="3">RTF</font><font face="宋体" lang="ZH-CN" size="3">文件的目录</font><font
face="Arial" size="3"></p>
<p></font><font face="宋体" lang="ZH-CN" size="3">●</font><font size="3"> </font><font
face="宋体" lang="ZH-CN" size="3">运行关键词文件产生程序——</font><font