VSTO
本教程介绍如何创建 VSTO 加载项并将 DotNetBrowser 嵌入到 Microsoft Outlook 中。
DotNetBrowser 提供了一个 WinForms BrowserView
控件,它可以与 VSTO 加载项一起使用,以将基于 Chromium 的浏览器添加为 Microsoft Office 应用程序的组成部分。 在本教程中,我们将展示如何将 BrowserView
控件嵌入到 Microsoft Outlook 检查器中。
实现
将 DotNetBrowser 添加到 Add-in(插件) 项目中
在 Visual Studio 中,为 Microsoft Outlook 创建一个示例插件项目。 您可以在 “VSTO Add-ins” 部分找到相应的项目模板:
将所有必要的引用添加到我们的项目中。 要执行此操作,请在 Solution Explorer 中,右键单击 References 节点并选择 Add Reference…:
选择所有需要的 DotNetBrowser 程序集并单击 Add:
请确保 DotNetBrowser 许可证也按照本文章中的说明进行了配置。
为使插件调试更加方便,请在插件初始化过程中配置 DotNetBrowser 日志,并指定日志文件的存储位置,如下所示:
创建表单区域
添加表单区域,用于替换或自定义标准 Outlook 表单。 要执行此操作,请在 Solution Explorer 中右键单击项目节点并选择 Add New Item:
指定如何创建 Outlook 表单区域。 要执行此操作,请选择 Design a new form region 选项并单击 Next.
选择表单区域类型。 在本教程中,我们将此表单区域创建为表单上的一个 separate 页面。
键入表单区域名称并选择此表单区域出现的检查器类型,然后单击 Next.
选择消息类别以指定表单区域应可用于哪些 Outlook 项目类型,然后单击 Finish。 例如,选择 IPM.Note
使表单区域可用于电子邮件消息。
在工具箱中添加 BrowserView 控件
创建表单区域后,表单区域设计器打开。 为了更加方便,请在 Visual Studio Toolbox 中添加 BrowserView
控件。 有几种方法可以做到这一点,其中最直接的是从程序集中手动添加它。 要执行此操作,请右键单击 Toolbox 并选择 Choose Items…:
Choose Toolbox Items 对话框出现。 点击 Browse 按钮将 BrowserView
控件添加到列表中:
在文件选择器中,选择包含 BrowserView
控件的 DotNetBrowser.WinForms
程序集:
确保 BrowserView
控件已被列出并选中,然后单击 OK。
BrowserView
控件出现在 Visual Studio Toolbox 中:
在表单区域添加 BrowserView
从 Toolbox 中将 BrowserView
控件添加到表单区域并调整其布局。 例如,您可以将其 Dock
属性指定为 Fill
以使用控件填充整个表单区域:
在显示区域之前,创建一个 IBrowser
实例并初始化 BrowserView
。
构建和运行项目
构建并运行项目,启动已配置示例插件的 Microsoft Outlook。 在 Outlook 窗口中,单击 New Email 按钮。
Microsoft Outlook 表单出现。 在表单功能区中,您会看到 BrowserFormRegion 按钮。
单击 BrowserFormRegion 按钮,以显示带有嵌入 BrowserView
的示例表单区域。