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

[アーティクル]
08/09/2011

Visual Studio の Office 開発ツールを使用して作成されたソリューションは、Windows フォームコントロールを使用して直接操作することを前提としていますが、ソリューションで WPF コントロールを使用することもできます。 Windows Presentation Foundation (WPF) は、ユーザーインターフェイスをデザインするときに Windows フォームの代わりとして使用できます。 WPF では、UI、メディア、および文書を取り込むための新しい手法として、Extensible Application Markup Language (XAML) というマークアップ言語を使用します。詳細については、「WPF の概要」を参照してください。

対象: このトピックの情報は、Microsoft Office 2010 および 2007 Microsoft Office system のドキュメントレベルのプロジェクトおよびアプリケーションレベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクトタイプ別の使用可能な機能」を参照してください。

Office ソリューションの Windows フォームコントロールをホストする UI 要素は、WPF コントロールもホストできます。そうした UI 要素には次のようなものがあります。

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

ビデオへのリンク関連のビデオデモについては、「How Do I: Use WPF Controls Inside an Excel Actions Pane? (操作方法: Excel 操作ウィンドウ内の WPF コントロールを使用する)」を参照してください。

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

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

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

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

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