Document ホスト項目

[アーティクル]
02/21/2013

Document ホスト項目は、Word のプライマリ相互運用機能アセンブリの Microsoft.Office.Interop.Word.Document 型を拡張する型です。Document ホスト項目は Microsoft.Office.Interop.Word.Document オブジェクトと同一のプロパティ、メソッド、およびイベントをすべて提供します。また、追加のイベントも公開し、ホストコントロールおよび Windows フォームコントロールのコンテナーとしても機能します。

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

ドキュメントレベルのプロジェクトには、プロジェクト内のドキュメントを表す既定の Document ホスト項目があります。アプリケーションレベルのプロジェクトでは、実行時に Document ホスト項目を生成できます。

ドキュメントレベルのプロジェクトの Document ホスト項目について

プロジェクトのドキュメントにアクセスするには、ThisDocument クラスを使用します。ドキュメントレベルのプロジェクトを作成すると、Word とカスタマイズコードとの通信リンクとして機能する ThisDocument クラスが Visual Studio によって生成されます。ThisDocument クラスによって、Document ホスト項目のメンバーにアクセスし、文書が開かれたり閉じられたりしたときにコードを実行するなど、カスタマイズの基本的なタスクを実行できます。文書にコントロールを追加するには、クラスを使用します。さまざまな種類のコントロールを組み合わせ、コードを記述することによって、コントロールのデータへのバインド、ユーザー情報の収集、およびユーザーの操作への応答を実行できます。詳細については、「ドキュメントレベルのカスタマイズのプログラミング」を参照してください。

ThisDocument クラスには、プロジェクトでコードの記述を開始できる場所が用意されています。このクラスには、Word のプライマリ相互運用機能アセンブリの Microsoft.Office.Interop.Word.Document オブジェクトと同じプロパティ、メソッド、およびイベントがすべて用意されているため、ThisDocument を使用して Word のオブジェクトモデルにアクセスすることもできます。詳細については、「Word オブジェクトモデルの概要」を参照してください。

ドキュメントレベルのプロジェクトでの Document ホスト項目の制限

ドキュメントレベルのプロジェクトには、1 つの Document ホスト項目 (ThisDocument クラス) のみを含めることができます。デザイン時に新しい Document ホスト項目をプロジェクトに追加することはできません。また、実行時にドキュメントレベルのカスタマイズから新しい Document ホスト項目を作成することもできません。

実行時に新しい Word 文書を作成すると、その文書は Microsoft.Office.Interop.Word.Document 型になります。これはホスト項目ではないため、ホストコントロールや Windows フォームコントロールを含めることはできません。実行時に文書を作成する方法の詳細については、「方法: プログラムによって新しい文書を作成する」を参照してください。

アプリケーションレベルのプロジェクトの Document ホスト項目について

アプリケーションレベルのプロジェクトでは、Word で開いている任意の文書の Document ホスト項目を実行時に生成できます。関連付けられた文書にコントロールを追加するに Document のホスト項目を使用して、あるイベントを処理する Microsoft.Office.Interop.Word.Document で使用できないを追加します。

Document ホスト項目を生成するには、GetVstoObject メソッドを使用します。詳細については、「アプリケーションレベルのアドインにおける実行時の Word 文書や Excel ブックの拡張」を参照してください。