Outlook Add-in(COM加载项)技术指南（二）

Outlook Add-in(COM加载项)

技术指南

 

2 COM加载项的开发过程

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

 

2.1.开发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

得到整个模型的根对象。

 

 

Disclaimers：

Programmer’s Blog List：

博客堂

小气的神

飞鹰手记  飞鹰手记之.NET专版

蝈蝈俊

思归

[MVPLeader]Grace Zhang

豆腐

跟随大象的舞步

Don Box's Blog

Eric.Weblog()

The .NET Guy

[e-mail]

本文档仅供参考。本文档所包含的信息代表了在发布之日，zhengyun对所讨论问题的当前看法，zhengyun不保证所给信息在发布之日以后的准确性。

用户应清楚本文档的准确性及其使用可能带来的全部风险。可以复制和传播本文档，但须遵守以下条款：

1. 复制时不得修改原文，复制内容须包含所有页 ；
2. 所有副本均须含有 zhengyun的版权声明以及所提供的其它声明 ；
3. 不得以赢利为目的对本文档进行传播 。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=12755