Office ソリューションでの WPF コントロールの使用

[アーティクル]
04/28/2010

更新 : 2007 年 11 月

Windows Presentation Foundation (WPF) は、ユーザーインターフェイスをデザインするときに Windows フォームの代わりとして使用できます。WPF では、UI、メディア、および文書を取り込むための新しい手法として、Extensible Application Markup Language (XAML) というマークアップ言語を使用します。詳細については、「Windows Presentation Foundation の概要」を参照してください。

Visual Studio Tools for Office ソリューションは Windows フォームコントロールの使用を前提としていますが、WPF コントロールを使用することもできます。Visual Studio Tools for Office ソリューションの Windows フォームコントロールをホストする UI 要素は、WPF コントロールもホストできます。そうした UI 要素には次のようなものがあります。

ドキュメントレベルのカスタマイズに含まれる文書およびワークシート
ドキュメントレベルのカスタマイズに含まれる操作ウィンドウ
アプリケーションレベルのアドインに含まれるカスタム作業ウィンドウ
Outlook 用のアプリケーションレベルのアドイン内のフォーム領域

デザイン時における Visual Studio Tools for Office プロジェクトへの WPF コントロールの追加

Visual Studio Tools for Office ソリューションの UI 要素に WPF コントロールを直接追加することはできません。直接追加する代わりに、ユーザーコントロール (WPF) アイテムをプロジェクトに追加し、それを WPF コントロールのデザイン画面として使用します。次に、WPF ユーザーコントロールをプロジェクトの UI 要素に追加します。

操作ウィンドウ、カスタム作業ウィンドウ、またはフォーム領域に WPF コントロールを追加するには

カスタム作業ウィンドウ、操作ウィンドウ、またはフォーム領域を追加するプロジェクトを開きます。
プロジェクトにユーザーコントロール (WPF) アイテムを追加します。
[ツールボックス] から WPF ユーザーコントロールのデザイン画面に WPF コントロールを追加します。

既定では、WPF ユーザーコントロールデザイナを開くと、[ツールボックス] には WPF コントロールだけが含まれています。
プロジェクトをビルドします。
操作ウィンドウ、フォーム領域、またはカスタム作業ウィンドウをプロジェクトに追加します。
- フォーム領域の場合は、プロジェクトに Outlook フォーム領域アイテムを追加します。詳細については、「方法 : フォーム領域を Outlook アドインプロジェクトに追加する」を参照してください。
- 操作ウィンドウの場合は、プロジェクトに操作ウィンドウコントロール アイテムまたはユーザーコントロール アイテムを追加します。詳細については、「方法 : Word 文書に操作ウィンドウを追加する」および「方法 : Excel ブックに操作ウィンドウを追加する」を参照してください。
- カスタム作業ウィンドウの場合は、プロジェクトにユーザーコントロール アイテムを追加します。詳細については、「方法 : カスタム作業ウィンドウをアプリケーションに追加する」を参照してください。
[ツールボックス] の [ProjectName WPF ユーザーコントロール] タブから、操作ウィンドウ、フォーム領域、またはカスタム作業ウィンドウのデザイナに WPF ユーザーコントロールをドラッグします。

UI 要素内の WPF ユーザーコントロールをホストする ElementHost オブジェクトが自動的に作成されます。
プロジェクトを再ビルドします。

ドキュメントレベルのプロジェクト内の文書またはワークシートに WPF コントロールを追加するには

Word または Excel のドキュメントレベルのプロジェクトを開きます。
プロジェクトにユーザーコントロール (WPF) アイテムを追加します。
[ツールボックス] から WPF ユーザーコントロールのデザイン画面に WPF コントロールを追加します。
プロジェクトをビルドします。
ユーザーコントロール アイテム (Windows フォームユーザーコントロール) をプロジェクトに追加します。
Windows フォームユーザーコントロールのデザイナを開きます。
[ツールボックス] の [ProjectName WPF ユーザーコントロール] タブからデザイナに WPF ユーザーコントロールをドラッグします。

Windows フォームユーザーコントロール内の WPF ユーザーコントロールをホストする ElementHost オブジェクトが自動的に作成されます。
Windows フォームユーザーコントロールを文書またはブックにプログラムで追加するコードを作成します。詳細については、「実行時の Office ドキュメントへのコントロールの追加」を参照してください。

メモ :

Windows フォームユーザーコントロールをデザイナ上の文書またはワークシートにドラッグすることはできません。
プロジェクトを再ビルドします。

メモ :
Windows フォームユーザーコントロールをデザイナ上の文書またはワークシートにドラッグすることはできません。

ElementHost クラスによる WPF コントロールのホスト

Visual Studio Tools for Office にはソリューションでの Windows フォームコントロールの使用を可能にする機能がありますが、WPF コントロールを対象とする同様の機能はありません。たとえば、Windows フォームコントロールは、デザイン時には [ツールボックス] からのドラッグによって、また実行時にはヘルパーメソッドを使用して、文書やワークシートに追加できます。それに対し、これらの機能は WPF コントロールには使用できません。

WPF コントロールでは、Windows フォームコントロールまたはフォームと WPF コントロールとの間の統合レイヤとして ElementHost クラスを使用します。ElementHost クラスは、.NET Framework Version 3.0 以降に含まれています。

デザイン時に WPF コントロールをソリューションに追加すると、ElementHost オブジェクトが自動的に作成されます。ElementHost クラスをプログラムで使用する方法を説明するチュートリアルについては、「方法 : ElementHost を使用し、Windows フォームで Windows Presentation Foundation コントロールをホストする」を参照してください。