Outlook オブジェクト モデルの概要

Microsoft Office Outlook 用の VSTO アドインを開発するには、Outlook オブジェクト モデルによって提供されるオブジェクトを操作できます。 Outlook オブジェクト モデルは、ユーザー インターフェイス内のアイテムを表すクラスとインターフェイスを提供します。 たとえば、 Application オブジェクトはアプリケーション全体を表し、 Folder オブジェクトは電子メール メッセージまたはその他のアイテムを含むフォルダーを表し、 MailItem オブジェクトは電子メール メッセージを表します。

このトピックでは、Outlook オブジェクト モデルの主なオブジェクトの一部について簡単に説明します。 Outlook オブジェクト モデル全体の詳細については、「Outlook オブジェクト モデルの使用」ドキュメントを参照してください。

適用対象: このトピックの情報は、Outlook 用 VSTO アドイン プロジェクトに適用されます。 詳細については、「 Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。

Outlook プロジェクト内のオブジェクトにアクセスする

Outlook には、操作できる多くのオブジェクトが用意されています。 オブジェクト モデルを効果的に使用するには、次の最上位オブジェクトについて理解している必要があります。

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

アプリケーション オブジェクト

Application オブジェクトは Outlook アプリケーションを表し、Outlook オブジェクト モデルの最上位のオブジェクトです。 このオブジェクトの最も重要なメンバーの一部を次に示します。

• 電子メール メッセージ、タスク、予定などの新しいアイテムを作成するために使用できる CreateItem メソッド。

• Explorers プロパティ。Outlook ユーザー インターフェイス (UI) でフォルダーの内容を表示するウィンドウにアクセスするために使用できます。

• Inspectors プロパティ。電子メール メッセージや会議出席依頼など、1 つのアイテムの内容を表示するウィンドウにアクセスするために使用できます。

  Application オブジェクトのインスタンスを取得するには、プロジェクトの ThisAddIn クラスの Application フィールドを使用します。 詳細については、「 プログラム VSTO アドイン」を参照してください。

Explorer オブジェクト

Explorer オブジェクトは、電子メール メッセージ、タスク、予定などのアイテムを含むフォルダーの内容を表示するウィンドウを表します。 Explorer オブジェクトには、ウィンドウの変更に使用できるメソッドとプロパティ、およびウィンドウが変更されたときに発生するイベントが含まれます。

Explorer オブジェクトを取得するには、次のいずれかの操作を行います。

• Outlook のすべてのExplorers オブジェクトにアクセスするには、Application オブジェクトの Explorer プロパティを使用します。

• 現在フォーカスがあるActiveExplorerを取得するには、Application オブジェクトのExplorer メソッドを使用します。

• 現在のフォルダーのGetExplorerを取得するには、Folder オブジェクトの Explorer メソッドを使用します。

Inspector オブジェクト

Inspector オブジェクトは、電子メール メッセージ、タスク、予定などの 1 つのアイテムを表示するウィンドウを表します。 Inspector オブジェクトには、ウィンドウの変更に使用できるメソッドとプロパティ、およびウィンドウが変更されたときに発生するイベントが含まれます。

Inspector オブジェクトを取得するには、次のいずれかの操作を行います。

• Outlook のすべてのInspectors オブジェクトにアクセスするには、Application オブジェクトの Inspector プロパティを使用します。

• 現在フォーカスがあるActiveInspectorを取得するには、Application オブジェクトのInspector メソッドを使用します。

• GetInspectorやMailItemなど、特定の項目のAppointmentItemメソッドを使用して、関連付けられているインスペクターを取得します。

フォルダー オブジェクト

Folder オブジェクトは、電子メール メッセージ、連絡先、タスク、およびその他のアイテムを含むフォルダーを表します。 Outlook には、既定の Folder オブジェクトが 16 個用意されています。

既定の Folder オブジェクトは、 OlDefaultFolders 列挙値によって定義されます。 たとえば、

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox は、Outlook の 受信トレイ フォルダーに対応します。

既定の Folder にアクセスして新しい Folderを作成する方法を示す例については、「 方法: プログラムによってカスタム フォルダー項目を作成する」を参照してください。

MailItem オブジェクト

MailItem オブジェクトは、電子メール メッセージを表します。 MailItem オブジェクトは通常、 受信トレイ、 送信済みアイテム、 送信トレイなどのフォルダーにあります。 MailItem は、電子メール メッセージの作成と送信に使用できるプロパティとメソッドを公開します。

電子メール メッセージを作成する方法を示す例については、「 方法: プログラムによって電子メール アイテムを作成する」を参照してください。

AppointmentItem オブジェクト

AppointmentItem オブジェクトは、予定表フォルダー内の会議、1 回限りの予定、または定期的な予定または会議を表します。 AppointmentItem オブジェクトには、会議出席依頼への返信や転送などのアクションを実行するメソッドと、場所や時刻などの会議の詳細を指定するプロパティが含まれます。

予定を作成する方法を示す例については、「 方法: プログラムによって会議出席依頼を作成する」を参照してください。

TaskItem オブジェクト

TaskItem オブジェクトは、指定した期間内に実行されるタスクを表します。 TaskItem オブジェクトは タスク フォルダーにあります。

タスクを作成するには、 オブジェクトの Application メソッドを使用し、パラメーターの値olTaskItemを渡します。

ContactItem オブジェクト

ContactItemオブジェクトは、連絡先フォルダー内の連絡先を表します。 ContactItem オブジェクトには、住所、電子メール アドレス、電話番号など、ユーザーが表すさまざまな連絡先情報が含まれています。

新しい連絡先を作成する方法を示す例については、「 方法: プログラムによって Outlook の連絡先にエントリを追加する」を参照してください。 既存の連絡先を検索する方法を示す例については、「 方法: プログラムによって特定の連絡先を検索する」を参照してください。

Outlook オブジェクト モデルのドキュメントを使用する

Outlook オブジェクト モデルの詳細については、Outlook プライマリ相互運用機能アセンブリ (PIA) リファレンスと VBA オブジェクト モデルリファレンスを参照してください。

プライマリ相互運用機能アセンブリリファレンス

Outlook PIA リファレンスには、Outlook 2010 のプライマリ相互運用機能アセンブリの種類が記載されています。 詳細については、「 Outlook 2010 プライマリ相互運用機能アセンブリ リファレンス」を参照してください。

このドキュメントでは、PIA のすべての種類に関する情報を提供するだけでなく、PIA の構造と一般的な Outlook オートメーション タスクのコード例に関する追加情報も提供します。

VBA オブジェクト モデル リファレンス

VBA オブジェクト モデル参照は、Visual Basic for Applications (VBA) コードに公開されている Outlook オブジェクト モデルを文書化します。 詳細については、「 Outlook 2010 オブジェクト モデル リファレンス」を参照してください。

VBA オブジェクト モデル参照のすべてのオブジェクトとメンバーは、Outlook PIA の型とメンバーに対応します。 たとえば、VBA オブジェクト モデル参照の Inspector オブジェクトは、Outlook PIA の Inspector オブジェクトに対応します。 VBA オブジェクト モデルリファレンスには、ほとんどのプロパティ、メソッド、およびイベントのコード例が用意されていますが、Visual Studio を使用して作成した Outlook VSTO Add-In プロジェクトで VBA コードを使用する場合は、この参照の VBA コードを Visual Basic または Visual C# に変換する必要があります。

関連トピック