Document ホスト項目
Document ホスト項目は、Word のプライマリ相互運用機能アセンブリの Microsoft.Office.Interop.Word.Document 型を拡張する型です。 Document ホスト項目は Microsoft.Office.Interop.Word.Document オブジェクトと同一のプロパティ、メソッド、およびイベントをすべて提供します。また、追加のイベントも公開し、ホスト コントロールおよび Windows フォーム コントロールのコンテナーとしても機能します。
対象: このトピックの情報は、Word 2007 と Word 2010 のドキュメント レベルのプロジェクトおよびアプリケーション レベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。
ドキュメント レベルのプロジェクトには、プロジェクト内のドキュメントを表す既定の Document ホスト項目があります。 アプリケーション レベルのプロジェクトでは、実行時に Document ホスト項目を生成できます。
ドキュメント レベルのプロジェクトの Document ホスト項目について
プロジェクトのドキュメントにアクセスするには、ThisDocument クラスを使用します。 ドキュメント レベルのプロジェクトを作成すると、Word とカスタマイズ コードとの通信リンクとして機能する ThisDocument クラスが Visual Studio によって生成されます。 ThisDocument クラスによって、Document ホスト項目のメンバーにアクセスし、文書が開かれたり閉じられたりしたときにコードを実行するなど、カスタマイズの基本的なタスクを実行できます。 このクラスを使用して、文書にコントロールおよびスマート タグを追加することもできます。 さまざまな種類のコントロールを組み合わせ、コードを記述することによって、コントロールのデータへのバインド、ユーザー情報の収集、およびユーザーの操作への応答を実行できます。 詳細については、「ドキュメント レベルのカスタマイズのプログラミング」を参照してください。
注意
スマート タグは、Excel 2010 および Word 2010 では使用されていません。 詳細については、「スマート タグの概要」を参照してください。
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 ブックの拡張」を参照してください。