您可以通过将关键字分配给帮助文件中的主题来使用户能够查找和查看主题。关键字只是一个与一个或多个主题相关联的字符串。Windows帮助收集帮助文件中的所有关键字,将它们放在表中,并将其显示在“帮助主题”对话框的“索引”列表中。当用户选择关键字时,Windows帮助将显示相关的帮助主题,或显示主题列表,如果有多个主题与关键字关联,用户可以从中选择主题。
在应用程序中,您可以使用具有WinHelp的HELP_KEY,HELP_PARTIALKEY或HELP_MULTIKEY命令来搜索并显示基于全部或部分关键字的帮助主题。您可以指定命令,关键字字符串,帮助文件和所有者窗口的句柄。在所有情况下,如果找到单个匹配,WinHelp将显示相应的主题。如果找到多个匹配,该函数将显示“找到主题”对话框,让用户选择要查看的主题。如果找不到匹配项,WinHelp将显示索引列表(对于HELP_KEY和HELP_PARTIALKEY)或显示错误消息(对于HELP_MULTIKEY)。
您可以通过单独调用WinHelp来搜索多个关键字,方法是用分号(;)分隔每个关键字与前一个关键字。(搜索多个关键字不支持为版本3创建的帮助文件。【x】.)如果您指定的帮助文件包含{.CNT)文件,您还可以跨多个帮助文件搜索关键字{ 989796018}或:链接命令。使用HELP_KEY命令,WinHelp在这些命令指定的所有文件中搜索关键字。使用HELP_MULTIKEY和HELP_PARTIALKEY命令,该函数将搜索除:链接命令指定的所有文件。
默认情况下,Windows帮助仅识别帮助源文件中的【K】脚注字符标识的关键字表。您可以通过在Windows帮助文件中使用关键字定义指定【K】以外的脚注字符来指示Windows帮助来创建其他关键字表。(然而,脚注字符【A】保留。)在构建帮助文件时,必须在项目文件的[OPTIONS]部分中使用MULTIKEY语句来定义任何其他关键字表。
应用程序可以使用HELP_SETINDEX命令与WinHelp功能来引导Windows帮助在其索引列表中显示除【K】之外的关键字表。要引导Windows帮助在备用关键字表中搜索关键字,应用程序可以使用HELP_MULTIKEY命令。您可以在MULTIKEYHELP结构中指定关键字和关键字表,您将传递给WinHelp.
当WinHelp显示主题时,它将显示在主题的>脚注指定的窗口中,或者在内容文件中的:基础命令或主窗口中指定的窗口中。如果在调用WinHelp时主窗口已经打开到其他帮助文件,则该函数在搜索时隐藏主窗口。在这种情况下,取消“主题找到”和“帮助主题”对话框,关闭主窗口。