Outlook Add-in(COM加载项)

技术指南

加载项的开发过程

摘要：本章节详细介绍了Outlook Add-in插件的开发过程。

开发COM加载项

在VB中，首先需要引用“Microsoft  Add-in Designer”类型库，该库包含了一些COM加载项必需的界面。

其次，Visual Basic中需要“Implements IDTExtensibility2”。

更多信息

一个Office2000下的内部COM插件必须实现一个_IDTExtensibility2派发接口。

_IDTExtensibility2派发接口被定义在MSADDin Designer类型库(MSADDNDR.dll/MSADDNDR.tlb)中，它通常位于<盘符>/Program Files/Common Files/Designer下。

_IDTExtensibility2接口中必须实现下面五个接口事件函数(一般只需编写OnConnection和OnDisconnection中代码)。

2.1.1. IDTExtensibility2事件背景知识

IDTExtensibility2提供了5个将用于COM加载项的事件：

Ø         OnConnection      装载插件到内存时处理(可以通过自动化在程序启动时自动装载插件)。

Ø         OnDisconnection   从内存中缷载插件时处理。

Ø         OnStartupComplete 当应用程序启动时插件刚装载完成时处理。

Ø         OnBeginShutdown  当应用程序关闭时插件刚缷载完成时处理。

Ø         OnAddInsUpdate    COM插件改变时处理。

下面我们一一介绍这些事件：

2.1.1.1. OnConnection事件

当第一次加载或者连接加载项时，例如Outlook启动时，或者当用户选择加载COM加载项时，将调用OnConnection事件。

OnConnection事件是获取或存储稍候将要在代码中使用的Outlook的Application队形最好的地方。

当发生OnConnection事件，将传递以下四个参数：

Application参数：是Outlook的Application的引用。

ConnectMode参数：COM加载项的加载方式。可以是以下常量中的一种：ext_cm_AfterStartup,ext_cm_CommandLine,ext_cm_External或者ext_cm_Startup。当Outlook启动时连接我们的加载项，这个参数被设置为ext_cm_Startup。

AddInInst参数：传递引用COM加载项当前实例的对象。

Custom()参数：一个Variant数据类型的阵列，可以存储用户定义的加载项数。对于Office2000加载项，本参数忽略。

2.1.1.2. OnDisconnection事件

当COM加载项与应用程序断开连接时，将发生OnDisconnection事件。

当发生OnDisconnection事件，将传递以下两个参数：

RemoveMode参数：指定加载项的断开方式，它可以被设置为以下常量：ext_dm_HostShutdown或ext_dm_UserClosed。顾名思义，ext_dm_HostShutdown表示加载项通过关闭主机来断开；ext_dm_UserClosed表示用户在“COM加载项”对话框中取消选中加载项的复选框或加载项的Connect属性被设置为False时断开加载项。

Custom()参数：一个Variant数据类型的阵列，可以存储用户定义的加载项数。对于Office2000加载项，本参数忽略。

可以使用OnDisconnection事件来恢复对应用程序所做的更改，或者执行常规的应用程序来清理操作。

确保撤销您创建的所有检测对象，因为如果这些对象仍旧存在，那么Outlook将无法正常关闭。

2.1.1.3.OnStartupComplete事件

对于在启动主控应用程序时连接COM加载项的情况，当主机完成所有的启动例程时，将触发OnStartupComplete事件。如果用户在加载应用程序后从“COM加载项”选择加载项时，不会发生OnStartupComplete事件。在这种情况下，将发生OnConnection事件。

该事件过程是将一些全局和本地变量设置为与它们相应的Outlook对象的好地方。

2.1.1.4.OnBeginShutdown事件

当应用程序将要关闭并且在OnDisconnection事件之前调用时，将触发OnBeginShutdown事件。甚至在触发OnBeginShutdown事件之后，您仍然完全可以访问Outlook对象模型，因此您可以卸载对象之前保存注册表或者文件的设置，也可以保存对您的对象所做的修改。

2.1.1.5.OnAddInsUpdate事件

当更新COM加载项的列表时，将触发OnAddInsUpdate事件。可以使用本事件来确保您的加载项所以来的其他加载项是连接的。

2.1.2.我们实现的 IDTExtensibility2事件

2.1.2.1. IDTExtensibility2_OnConnection事件

OnConnection事件中，我们预先读取注册表，把默认参数读出来。

同时，通过调用

Set g_oApplication = Application

得到整个模型的根对象。