VSTO

本教程介绍如何创建 VSTO 加载项并将 DotNetBrowser 嵌入到 Microsoft Outlook 中。

DotNetBrowser 提供了一个 WinForms BrowserView 控件,它可以与 VSTO 加载项一起使用,以将基于 Chromium 的浏览器添加为 Microsoft Office 应用程序的组成部分。 在本教程中,我们将展示如何将 BrowserView 控件嵌入到 Microsoft Outlook 检查器中。

实现

将 DotNetBrowser 添加到加载项项目

在 Visual Studio 中,为 Microsoft Outlook 创建一个示例加载项项目。 您可以在 “VSTO Add-ins” 部分找到对应的项目模板:

Create Add-in Project

将所有必要的引用添加到我们的项目中。 为此,在 Solution Explorer 中,右键单击 References 节点并选择 Add Reference…:

Add Reference

选择所有需要的 DotNetBrowser 程序集并单击 Add:

Select Referenced Assemblies

确保 DotNetBrowser 许可证也按照本文的描述进行配置。

为了使加载项调试更方便,在加载项初始化时配置 DotNetBrowser 日志记录,并指定日志文件的存储位置,如下所示:

Configure Logging

创建表单区域

添加用于替换或自定义标准 Outlook 表单的表单区域。 为此,请在 Solution Explorer 中右键单击项目节点并选择 Add New Item:

Add Form Region

指定如何创建 Outlook 表单区域。 为此,选择 Design a new form region 选项并单击 Next.

Design New Form Region

选择表单区域类型。 在本教程中,我们将此表单区域创建为表单上的一个单独页面。

Select Form Region Type

键入表单区域名称并选择此表单区域出现的检查器类型,然后单击 Next.

Specify Form Region Name

选择消息类别以指定表单区域应该可用的 Outlook 项目类型,然后单击 Finish。 例如,选择 IPM.Note 使表单区域可用于电子邮件消息。

Select Message Classes

将 BrowserView 控件添加到工具箱

创建表单区域后,表单区域设计器打开。 为了更方便,将 BrowserView 控件添加到 Visual Studio Toolbox 中。 有几种方法可以做到这一点,其中最直接的是从程序集中手动添加它。 为此,请右键单击 Toolbox 并选择 Choose Items…:

Choose Toolbox Items

Choose Toolbox Items 对话框出现。 点击 Browse 按钮将 BrowserView 控件添加到列表中:

Browse Toolbox Items

在文件选择器中,选择包含 BrowserView 控件的 DotNetBrowser.WinForms 程序集:

Select Toolbox Item Assembly

确保 BrowserView 控件现在已列出并被选中,然后单击 OK.

Select Framework Component

BrowserView 控件出现在 Visual Studio Toolbox 中:

BrowserView In Toolbox

将 BrowserView 添加到表单区域

Toolbox 中将 BrowserView 控件添加到表单区域并调整其布局。 例如,您可以将其 Dock 属性指定为 Fill 以使用控件填充整个表单区域:

Designer With BrowserView

创建一个 IBrowser 实例并在区域显示之前初始化 BrowserView

BrowserView Initialization

构建和运行项目

构建并运行项目以启动 Microsoft Outlook,并配置示例加载项。 在 Outlook 窗口中,单击 New Email 按钮。

New Email

Microsoft Outlook 表单出现。 在表单功能区中,您会注意到 BrowserFormRegion 按钮。

BrowserView In Toolbox

单击 BrowserFormRegion 按钮,以显示带有嵌入的 BrowserView 的示例表单区域。

BrowserView In Toolbox

Go Top