次の方法で共有


Document ホスト項目

更新 : 2008 年 7 月

対象

このトピックの情報は、指定された 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 オブジェクト モデルの概要」を参照してください。

Document ホスト項目の制限

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

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

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

SP1 より、Word 内で開かれている任意の文書に対して、実行時に Document ホスト項目を生成できるようになりました。Document ホスト項目を使用して、関連付けられている文書にコントロールおよびスマート タグを追加できます。

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

参照

概念

ホスト項目とホスト コントロールの概要

Word オブジェクト モデルの概要

ホスト項目およびホスト コントロールのプログラム上の制限事項

アプリケーション レベルのアドインにおける実行時の Word 文書や Excel ブックの拡張

その他の技術情報

Word ホスト コントロール

Excel のホスト コントロール

変更履歴

日付

履歴

理由

2008 年 7 月

アプリケーション レベルのプロジェクトでの Document ホスト項目の使用に関する情報を追加

SP1 機能変更