Outlook 物件模型概觀
更新:2007 年 11 月
若要開發 Microsoft Office Outlook 的增益集,您可以與 Outlook 物件模型提供的物件進行互動。此 Outlook 物件模型會提供表示使用者介面中各種項目的類別。例如,Application 類別是表示整個應用程式、MAPIFolder 類別是表示含有電子郵件訊息或其他項目的資料夾,而 MailItem 類別則是表示電子郵件訊息。
此主題提供 Outlook 物件模型中部分主要類別的簡短概觀。如需 Outlook 物件模型的完整文件,請參閱 MSDN 章節 Outlook 2007 開發人員參考和歡迎使用 Microsoft Office Outlook 2003 VBA 語言參考。
在 Outlook 專案中存取物件
Outlook 會提供許多您可以與之互動的類別。若要有效使用物件模型,您應該熟悉下列最上層類別:
Application 類別
Application 類別是表示 Outlook 應用程式,而且它是 Outlook 物件模型中的最上層類別。這個類別中某些最重要的成員包括:
CreateItem 方法,您可用來建立電子郵件訊息、工作或約會等新項目。
Explorers 屬性,您可用來存取在 Outlook 使用者介面 (UI) 中顯示資料夾內容的視窗。
Inspectors 屬性,您可用來存取顯示單一項目內容的視窗,例如電子郵件訊息或會議邀請。
若要取得 Application 類別的執行個體 (Instance),請使用 ThisAddin 類別的 Application 屬性。
ThisAddIn 類別
建立新的 Outlook 增益集專案時,Visual Studio Tools for Office 會自動在新的專案中建立 ThisAddIn.vb 或 ThisAddIn.cs 程式碼檔案。這個程式碼檔會定義繼承自 OutlookAddIn 的 ThisAddin 類別。您可以存取 OutlookAddIn 類別的成員,方法為在 ThisAddIn 類別內使用關鍵字 Me (Visual Basic) 或 this (C#)。在 ThisAddIn 類別外的程式碼可使用靜態 Globals.ThisAddIn 屬性存取 ThisAddIn 物件。
注意事項: |
---|
若不想在使用受 Outlook 物件模型保護功能封鎖的屬性或方法時看見安全性警告,請從 ThisAddIn 物件取得 Outlook 物件。如需詳細資訊,請參閱 指定 Office 方案的安全性考量。 |
Explorer 類別
Explorer 類別是表示顯示含有項目之資料夾內容的視窗,而這些項目包括電子郵件訊息、工作或約會。Explorer 類別含有一些方法和屬性,可讓您用來修改視窗,以及視窗變更時引發的事件。
若要取得 Explorer 物件,請進行下列其中一項動作:
使用 Application 類別的 Explorers 屬性來存取 Outlook 中的所有 Explorer 物件。
使用 Application 類別的 ActiveExplorer 方法來取得目前具有焦點 (Focus) 的 Explorer。
使用 MAPIFolder 類別的 GetExplorer 方法來取得目前資料夾的 Explorer。
Inspector 類別
Inspector 類別是表示顯示單一項目的視窗,而這些項目包括電子郵件訊息、工作或約會。Inspector 類別含有一些方法和屬性,可讓您用來修改視窗,以及視窗變更時引發的事件。
若要取得 Inspector 物件,請進行下列其中一項動作:
使用 Application 類別的 Inspectors 屬性來存取 Outlook 中的所有 Inspector 物件。
使用 Application 類別的 ActiveInspector 方法來取得目前具有焦點的 Inspector。
使用特定項目 (例如 MailItem 或 AppointmentItem) 的 GetInspector 方法來擷取與該項目相關聯的偵測器。
MAPIFolder 類別
MAPIFolder 類別是表示含有電子郵件訊息、連絡人、工作和其他項目的資料夾。Outlook 會提供 16 個預設的 MAPIFolder 物件。
這些預設的 MAPIFolder 物件是由 OlDefaultFolders 列舉值所定義。例如:
T:Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox 會對應至 Outlook 中的 [收件匣] 資料夾。
如需示範如何存取預設 MAPIFolder 並建立新 MAPIFolder 的範例,請參閱 HOW TO:建立自訂資料夾項目。
MailItem 類別
MailItem 類別表示電子郵件訊息。MailItem 物件通常是位於 [收件匣]、[寄件備份] 和 [寄件匣] 等資料夾中。MailItem 會公開 (Expose) 可用來建立和傳送電子郵件訊息的屬性和方法。
如需示範如何建立電子郵件訊息的範例,請參閱 HOW TO:建立電子郵件項目。
AppointmentItem 類別
AppointmentItem 類別是表示 [行事曆] 資料夾中的會議、一次性約會或是週期性約會或會議。AppointmentItem 類別含有一些可執行回應或轉寄會議邀請等動作的方法,以及一些可指定地點和時間等會議細節的屬性。
如需示範如何建立約會的範例,請參閱 HOW TO:建立會議邀請。
TaskItem 類別
TaskItem 類別是表示要在指定的時間內執行的工作。TaskItem 物件會位於 [工作] 資料夾中。
若要建立工作,請使用 Application 類別的 CreateItem 方法,並傳入 olTaskItem 值做為參數。
ContactItem 類別
ContactItem類別是表示 [連絡人] 資料夾中的連絡人。ContactItem 物件含有它們所表示之人員的各種連絡資訊,例如街道地址、電子郵件地址和電話號碼。
如需示範如何建立新連絡人的範例,請參閱 HOW TO:將項目加入至 Outlook 連絡人。如需示範如何搜尋現有連絡人的範例,請參閱 HOW TO:搜尋特定的連絡人。
使用 Outlook 物件模型文件
如需您可以在 Outlook 物件模型中使用之類別的詳細資訊,請參閱下列文件:
第一個連結提供 Outlook 主要 Interop 組件中之類別和介面的詳細資訊。其他連結則提供 Outlook 物件模型公開 (Expose) 給 Visual Basic for Application (VBA) 程式碼時的詳細資訊。對於使用 Visual Studio Tools for Office 的開發人員來說,每組文件都各有優缺點。
主要 Interop 組件參考
這份文件說明 Outlook 主要 Interop 組件中所有可用在 Visual Studio Tools for Office 專案中的型別:
它描述 Outlook 2007 的主要 Interop 組件中的型別。因此,如果您要開發 Outlook 2003 增益集,將無法使用這個文件中的某些類別和成員。如需 Outlook 2003 可用之型別和成員的描述,請參閱 Microsoft Office Outlook 2003 VBA 語言參考。
目前不提供任何程式碼範例。
VBA 參考
VBA 參考中的所有物件和成員都對應至主要 Interop 組件中供您用在 Visual Studio Tools for Office 專案中的類別和成員。例如,Outlook VBA 文件中的 Inspector 物件就對應至主要 Interop 組件中的 Microsoft.Office.Interop.Outlook.Inspector 類別。
VBA 參考有下列優點:
- 提供大多數成員的程式碼範例。
VBA 參考有下列缺點:
- 只提供 VBA 的語法和程式碼範例。若要在 Visual Studio Tools for Office 專案中使用程式碼範例,您必須將 VBA 程式碼轉譯為 Visual Basic 或 Visual C#。
主要 Interop 組件中的其他型別
主要 Interop 組件包含許多不適用於 VBA 的類型。這些額外型別會協助將 Outlook 的 COM 架構物件模型轉譯成 Managed 程式碼,不適合直接在程式碼中使用。
如需詳細資訊,請參閱 Outlook PIA 架構。
請參閱
工作
HOW TO:將 Windows Form 加入至 Outlook 方案
HOW TO:將自訂功能表和功能表項目加入至 Outlook
HOW TO:將自訂工具列和工具列項目加入至 Outlook
HOW TO:在 Outlook 工作階段之間維護自訂工具列的位置資訊