Document ホスト項目

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

更新 : 2008 年 7 月

対象
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。ドキュメントレベルのプロジェクト Word 2003 Word 2007 アプリケーションレベルのプロジェクト Word 2007 詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。

ドキュメントレベルのプロジェクト

Word 2003
Word 2007

アプリケーションレベルのプロジェクト

Word 2007

詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

Document ホスト項目は、イベントを公開し、また、ホストコントロールと Windows フォームコントロールのコンテナとなる Word 文書を表します。また、Document ホスト項目には、Word のプライマリ相互運用機能アセンブリの Microsoft.Office.Interop.Word.Document クラスと同じプロパティ、メソッド、およびイベントが用意されています。

ドキュメントレベルのプロジェクトには、プロジェクト内のドキュメントを表す Document ホスト項目があります。Visual Studio 2008 Service Pack 1 (SP1) より、Word 2007 用のアプリケーションレベルのアドインを使用して、実行時に Document ホスト項目を生成することもできるようになりました。

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

プログラムによってプロジェクトのドキュメントにアクセスするには、ThisDocument クラスを使用します。ドキュメントレベルのプロジェクトを作成すると、Visual Studio Tools for Office は、Word とカスタマイズコードとの通信リンクの役割を果たすものとして、ThisDocument クラスを生成します。ThisDocument クラスは、Document ホスト項目クラスから派生します。Visual Studio Tools for Office は、実行時にドキュメントが開かれたときに ThisDocument クラスを自動的にインスタンス化します。コードで直接 Document クラスをインスタンス化しないでください。

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

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