如何:在 Windows 应用程序中提供帮助
可以利用 HelpProvider 组件将帮助文件中的帮助主题附加到 Windows 窗体的特定控件。 帮助文件可以是 HTML、HTMLHelp 1.x 或更高版本的格式。
提供帮助
在 Visual Studio 中,将 HelpProvider 组件从“工具箱”拖动到窗体。
该组件将位于 Windows 窗体设计器底部的栏中。
在“属性”窗口中,将 HelpNamespace 属性的值设置为 .chm、.col 或 .htm 帮助文件。
选择窗体上的另一个控件,在“属性”窗口中设置 SetHelpKeyword 属性。
这是通过 HelpProvider 组件传递给帮助文件的字符串,用于请求相应的帮助主题。
在“属性”窗口中,将 SetHelpNavigator 属性设置为 HelpNavigator 枚举的值。
这可确定以何种方式将 HelpKeyword 属性传递给帮助系统。 下表显示可能的设置及其说明。
成员名称 说明 AssociateIndex 指定在指定 URL 中执行指定主题的索引。 查找 指定显示指定 URL 的搜索页。 Index 指定显示指定 URL 的索引。 KeywordIndex 指定要搜索的关键字和要在指定 URL 中采取的操作。 TableOfContents 指定显示 HTML 1.0 帮助文件的目录。 主题 指定显示指定 URL 引用的主题。
在运行时,如果在已设置 HelpKeyword 和 HelpNavigator 属性的控件具有焦点时按 F1,系统会打开与 HelpProvider 组件关联的帮助文件。
目前,HelpNamespace 属性支持下列三种格式的帮助文件:HTMLHelp 1.x、HTMLHelp 2.0 和 HTML。 因此,可以将 HelpNamespace 属性设置为 http://
地址(如网页)。 如果此操作已完成,系统会打开默认浏览器,并显示作为定位标记的 HelpKeyword 属性中指定的字符串所对应的网页。 定位标记用于跳转到 HTML 页的特定部分。
重要
一定要先仔细检查从客户端发来的所有信息,再在应用程序中使用这些信息。 恶意用户可能会尝试发送或注入可执行脚本、SQL 语句或其他代码。 显示用户的输入、将其存储在数据库中或使用它之前,请确定它没有包含可能的不安全信息。 通常的检查方法是在收到某个用户发来的输入后,使用正则表达式查找关键字,如“SCRIPT”。
还可使用 HelpProvider 组件显示弹出帮助(即使已经将其配置为显示 Windows 窗体上控件的帮助文件)。 有关详细信息,请参阅如何:显示弹出帮助。