我们一直在 vb.net 桌面应用程序中使用 PDF 文件作为帮助文档的一部分。在 PDF 中,我们将遍历 PDF 文档中的特定章节。
现在我们决定使用MadCap Flare作为文档工具。我们有一个 vb.net 形式的菜单项用于文档。单击链接后,我们要打开 Flare 文档的特定章节。
您知道在使用 MapCad Flare 时可以使用单源 XML 创作来管理内容(我没有使用 Flare!)。您可以通过 MapCad Flare 将内容发布为越来越多的格式,包括 HTML5、WebHelp、PDF、Word、XHTML、Clean XHTML、EPUB、DITA 等。
因此,您可以继续使用 PDF 和连接您的 vb.net 桌面应用程序帮助的方式。
使用基于 HTML 的主题可能是您需要的另一种解决方案,方法是为带有 HTML 文件的表单、对话框或控件创建帮助(另请参见:使用 VB .NET 的控件的帮助)。
显示帮助的属性(HTML 文件 - 本地)
激活 hlpProvider 组件 hlpHtmlLocal 并将 hlpHtmlLocal 的 HelpNameSpace 属性设置为您要使用的文件名。
我们使用右侧的小按钮打开带有对话框的本地 HTML 文件。
下一步是将控件(例如按钮)的 HelpNavigator 属性设置为 HelpNavigator 枚举的值(见下表)。这里我们使用主题。
当应用程序运行时,单击帮助按钮以启用“这是什么..”帮助。光标改变。现在单击按钮或在按钮获得焦点时按 F1。这将在您的浏览器中打开单个 HTML 文件。
看来您不能使用锚名称来跳转到 HTML 文件的特定部分。
显示帮助的属性(HTML 文件 - 服务器http:// ..)
激活 hlpProvider 组件并将 hlpHtmlServer 的 HelpNameSpace 属性设置为您要使用的文件名。这里我们使用单个 HTML 文件的 http:// 地址。如果您在公司服务器上提供该文件,则无需向客户更新帮助文件。
下一步是将控件(例如按钮)的 HelpNavigator 属性设置为 HelpNavigator 枚举的值(见下表)。这里我们使用主题。然后我们将 hlpHtmlSever 属性上的 HelpKeyword 设置为例如“anchor3”。不要添加前导“#”。如果要打开没有锚点的 HTML 文件,请将其留空。帮助句柄 cmdControl2.Click Dim sHelpFile As String Dim sStartupPath As String '--- 初始化上下文相关帮助 --- Keyword 属性提供了检索与控件关联的帮助的关键信息。
当应用程序运行时,单击帮助按钮以启用“这是什么..”帮助。光标改变。现在单击按钮或在按钮获得焦点时按 F1。这将在您的浏览器中通过 Internet 打开单个 HTML 文件。