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

  • [アーティクル]

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

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

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

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

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

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

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

  • CreateItem メソッド。これを使用して、電子メール メッセージ、タスク、予定などの新しい項目を作成できます。

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

  • Inspectors プロパティ。これを使用して、電子メール メッセージや会議出席依頼などの単一の項目の内容を表示するウィンドウにアクセスできます。

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

Note

Outlook オブジェクト モデルの保護によってブロックされているプロパティとメソッドを使用するときに、セキュリティの警告が出ないようにするには、ThisAddIn クラスの Application フィールドから Outlook オブジェクトを取得します。 詳細については、「Office ソリューションに関する特定のセキュリティの考慮事項」を参照してください。

Explorer オブジェクト

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

Explorer オブジェクトを取得するには、以下のいずれかを実行します。

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

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

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

Inspector オブジェクト

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

Inspector オブジェクトを取得するには、以下のいずれかを実行します。

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

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

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

フォルダー オブジェクト

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

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

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

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

MailItem オブジェクト

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

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

AppointmentItem オブジェクト

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

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

TaskItem オブジェクト

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

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

ContactItem オブジェクト

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

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

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

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

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

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

この資料には、PIA の型すべての情報を提供されています。さらに、PAI の構造に関する詳細情報と、一般的な Outlook 自動化タスクのコード例も提供されています。

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

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

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

Title 説明
連絡先アイテムを操作する アドレス帳を使用したさまざまなタスクを実行する方法を説明するトピックを提供します。
メール アイテムを操作する メール アイテムを使用してタスクを実行する方法を説明するトピックを提供します。
フォルダーを操作する フォルダーを使用してタスクを実行する方法を説明するトピックを提供します。
予定表アイテムを操作する 予定表アイテムを使用してタスクを実行する方法を説明するトピックを提供します。
方法: プログラムによって現在の Outlook のアイテムを確認する 現在のフォルダー名と、選択したアイテムに関する情報を表示する方法を示します。