Outlook Add-in (COM 加載項(xiàng) )

技術(shù)指南

?

2 COM 加載項(xiàng)的開(kāi)發(fā)過(guò)程

摘要 ：本章節(jié)詳細(xì)介紹了 Outlook Add-in 插件的開(kāi)發(fā)過(guò)程。

?

2.1. 開(kāi)發(fā) COM 加載項(xiàng)

在 VB 中，首先需要引用“ Microsoft ? Add-in Designer ”類型庫(kù)，該庫(kù)包含了一些 COM 加載項(xiàng)必需的界面。

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

?

更多信息

一個(gè) Office2000 下的內(nèi)部 COM 插件必須實(shí)現(xiàn)一個(gè) _IDTExtensibility2 派發(fā)接口。

_IDTExtensibility2 派發(fā)接口被定義在 MSADDin Designer 類型庫(kù) (MSADDNDR.dll/MSADDNDR.tlb) 中，它通常位于 < 盤(pán)符 >/Program Files/Common Files/Designer 下。

_IDTExtensibility2 接口中必須實(shí)現(xiàn)下面五個(gè)接口事件函數(shù) ( 一般只需編寫(xiě) OnConnection 和 OnDisconnection 中代碼 ) 。

2.1.1 . IDTExtensibility2 事件背景知識(shí)

I DTExtensibility2 提供了 5 個(gè)將用于 COM 加載項(xiàng)的事件：

? ???????? OnConnection ??? ? ? 裝載插件到內(nèi)存時(shí)處理 ( 可以通過(guò)自動(dòng)化在程序啟動(dòng)時(shí)自動(dòng)裝載插件 ) 。

? ???????? OnDisconnection ?? 從內(nèi)存中缷載插件時(shí)處理。

? ???????? OnStartupComplete 當(dāng)應(yīng)用程序啟動(dòng)時(shí)插件剛裝載完成時(shí)處理。

? ???????? OnBeginShutdown ? 當(dāng)應(yīng)用程序關(guān)閉時(shí)插件剛缷載完成時(shí)處理。

? ???????? OnAddInsUpdate ? ?? COM 插件改變時(shí)處理。

下面我們一一介紹這些事件：

?

2.1.1 .1. OnConnection 事件

當(dāng)?shù)谝淮渭虞d或者連接加載項(xiàng)時(shí)，例如 Outlook 啟動(dòng)時(shí)，或者當(dāng)用戶選擇加載 COM 加載項(xiàng)時(shí)，將調(diào)用 OnConnection 事件。

OnConnection 事件是獲取或存儲(chǔ)稍候?qū)⒁诖a中使用的 Outlook 的 Application 隊(duì)形最好的地方。

當(dāng)發(fā)生 OnConnection 事件，將傳遞以下四個(gè)參數(shù)：

Application 參數(shù)：是 Outlook 的 Application 的引用。

ConnectMode 參數(shù)： COM 加載項(xiàng)的加載方式。可以是以下常量中的一種： ext_cm_AfterStartup,ext_cm_CommandLine,ext_cm_External 或者 ext_cm_Startup 。當(dāng) Outlook 啟動(dòng)時(shí)連接我們的加載項(xiàng)，這個(gè)參數(shù)被設(shè)置為 ext_cm_Startup 。

AddInInst 參數(shù)：傳遞引用 COM 加載項(xiàng)當(dāng)前實(shí)例的對(duì)象。

Custom() 參數(shù)：一個(gè) Variant 數(shù)據(jù)類型的陣列，可以存儲(chǔ)用戶定義的加載項(xiàng)數(shù)。對(duì)于 Office2000 加載項(xiàng)，本參數(shù)忽略。

?

2.1.1 .2. OnDisconnection 事件

當(dāng) COM 加載項(xiàng)與應(yīng)用程序斷開(kāi)連接時(shí)，將發(fā)生 OnDisconnection 事件。

當(dāng)發(fā)生 OnDisconnection 事件，將傳遞以下兩個(gè)參數(shù)：

RemoveMode 參數(shù)：指定加載項(xiàng)的斷開(kāi)方式，它可以被設(shè)置為以下常量： ext_dm_HostShutdown 或 ext_dm_UserClosed 。顧名思義， ext_dm_HostShutdown 表示加載項(xiàng)通過(guò)關(guān)閉主機(jī)來(lái)斷開(kāi)； ext_dm_UserClosed 表示用戶在 “COM 加載項(xiàng) ” 對(duì)話框中取消選中加載項(xiàng)的復(fù)選框或加載項(xiàng)的 Connect 屬性被設(shè)置為 False 時(shí)斷開(kāi)加載項(xiàng)。

Custom() 參數(shù)：一個(gè) Variant 數(shù)據(jù)類型的陣列，可以存儲(chǔ)用戶定義的加載項(xiàng)數(shù)。對(duì)于 Office2000 加載項(xiàng)，本參數(shù)忽略。

可以使用 OnDisconnection 事件來(lái)恢復(fù)對(duì)應(yīng)用程序所做的更改，或者執(zhí)行常規(guī)的應(yīng)用程序來(lái)清理操作。

確保撤銷您創(chuàng)建的所有檢測(cè)對(duì)象，因?yàn)槿绻@些對(duì)象仍舊存在，那么 Outlook 將無(wú)法正常關(guān)閉。

?

2.1.1 .3. OnStartupComplete 事件

對(duì)于在啟動(dòng)主控應(yīng)用程序時(shí)連接 COM 加載項(xiàng)的情況，當(dāng)主機(jī)完成所有的啟動(dòng)例程時(shí)，將觸發(fā) OnStartupComplete 事件。如果用戶在加載應(yīng)用程序后從 “COM 加載項(xiàng) ” 選擇加載項(xiàng)時(shí)，不會(huì)發(fā)生 OnStartupComplete 事件。在這種情況下，將發(fā)生 OnConnection 事件。

該事件過(guò)程是將一些全局和本地變量設(shè)置為與它們相應(yīng)的 Outlook 對(duì)象的好地方。

?

2.1.1 .4. OnBeginShutdown 事件

當(dāng)應(yīng)用程序?qū)⒁P(guān)閉并且在 OnDisconnection 事件之前調(diào)用時(shí)，將觸發(fā) OnBeginShutdown 事件。甚至在觸發(fā) OnBeginShutdown 事件之后，您仍然完全可以訪問(wèn) Outlook 對(duì)象模型，因此您可以卸載對(duì)象之前保存注冊(cè)表或者文件的設(shè)置，也可以保存對(duì)您的對(duì)象所做的修改。

?

2.1.1 .5. OnAddInsUpdate 事件

當(dāng)更新 COM 加載項(xiàng)的列表時(shí)，將觸發(fā) OnAddInsUpdate 事件。可以使用本事件來(lái)確保您的加載項(xiàng)所以來(lái)的其他加載項(xiàng)是連接的。

?

2.1.2 . 我們實(shí)現(xiàn)的 IDTExtensibility2 事件

2.1.2 .1. IDTExtensibility2_OnConnection 事件

OnConnection 事件中，我們預(yù)先讀取注冊(cè)表，把默認(rèn)參數(shù)讀出來(lái)。

同時(shí)，通過(guò)調(diào)用

Set g_oApplication = Application

得到整個(gè)模型的根對(duì)象。

?

?

Disclaimers ：

Programmer’s Blog List ：

博客堂

小氣的神

飛鷹手記 ? 飛鷹手記之 .NET 專版

蟈蟈俊

思?xì)w

[MVPLeader] Grace Zhang

豆腐

跟隨大象的舞步

Don Box's Blog

Eric.Weblog()

The .NET Guy

Blogs@asp.net

?

本文檔僅供參考。本文檔所包含的信息代表了在發(fā)布之日， zhengyun 對(duì)所討論問(wèn)題的當(dāng)前看法， zhengyun 不保證所給信息在發(fā)布之日以后的準(zhǔn)確性。

用戶應(yīng)清楚本文檔的準(zhǔn)確性及其使用可能帶來(lái)的全部風(fēng)險(xiǎn)。可以復(fù)制和傳播 本文檔 ，但須遵守以下條款：

1. 復(fù)制時(shí)不得修改原文，復(fù)制內(nèi)容須包含所有頁(yè) ；
2. 所有副本均須含有 zhengyun 的版權(quán)聲明以及所提供的其它聲明 ；
3. 不得以贏利為目的對(duì)本文檔進(jìn)行傳播 。

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