Document ホスト項目は、Word のプライマリ相互運用機能アセンブリからDocument型を拡張する型です。 Documentホスト項目は、Document オブジェクトと同じプロパティ、メソッド、およびイベントをすべて提供しますが、追加のイベントも公開し、ホスト コントロールと Windows フォーム コントロールのコンテナーとして機能します。
適用対象: このトピックの情報は、Word のドキュメント レベルのプロジェクトと VSTO アドイン プロジェクトに適用されます。 詳細については、「 Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。
ドキュメント レベルのプロジェクトでは、プロジェクト内のドキュメントを表す既定の Document ホスト項目があります。 VSTO アドイン プロジェクトでは、実行時に Document ホスト項目を生成できます。
ドキュメントレベルのプロジェクトにおけるドキュメントホスト項目を理解する
プロジェクト内のドキュメントにアクセスするには、 ThisDocument クラスを使用します。 ドキュメント レベルのプロジェクトを作成すると、Visual Studio によって ThisDocument クラスが生成され、Word とカスタマイズ コード間の通信リンクとして機能します。
ThisDocument クラスを使用すると、Document ホスト項目のメンバーにアクセスして、ドキュメントを開いたり閉じたりするときにコードを実行するなど、カスタマイズで基本的なタスクを実行できます。 クラスを使用して、ドキュメントにコントロールを追加することもできます。 さまざまなコントロールセットを組み合わせてコードを記述することで、コントロールをデータにバインドし、ユーザーから情報を収集し、ユーザーアクションに応答することができます。 詳細については、「 プログラムのドキュメント レベルのカスタマイズ」を参照してください。
ThisDocument クラスは、プロジェクトでコードの記述を開始できる場所を提供します。 このクラスには、Word のプライマリ相互運用機能アセンブリの Document オブジェクトと同じプロパティ、メソッド、およびイベントがすべて用意されているため、 ThisDocument を使用して Word のオブジェクト モデルにアクセスすることもできます。 詳細については、「 Word オブジェクト モデルの概要」を参照してください。
ドキュメント レベルのプロジェクトでのドキュメント ホスト項目の制限事項
ドキュメント レベルのプロジェクトには、 Document ホスト項目 (つまり、 ThisDocument クラス) を 1 つだけ含めることができます。 デザイン時に新しい Document ホスト項目をプロジェクトに追加することはできません。また、ドキュメント レベルのカスタマイズから実行時に新しい Document ホスト項目を作成することはできません。
実行時に新しい Word 文書を作成する場合は、 Documentの種類になります。 ホスト項目ではないため、ホスト コントロールまたは Windows フォーム コントロールを含めることはできません。 実行時にドキュメントを作成する方法の詳細については、「 方法: プログラムによって新しいドキュメントを作成する」を参照してください。
アプリケーション レベルのプロジェクトのドキュメント ホスト項目について
VSTO アドイン プロジェクトでは、Word で開いている任意のドキュメントに対して、実行時に Document ホスト項目を生成できます。 Document ホスト項目を使用して、関連付けられたドキュメントにコントロールを追加したり、Document オブジェクトで使用できないイベントを処理したりできます。
Documentホスト項目を生成するには、GetVstoObject メソッドを使用します。 詳細については、「実行時に VSTO アドインで Word 文書と Excel ブックを拡張する」を参照してください。