次の方法で共有


Worksheet ホスト項目

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

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

ドキュメント レベルのプロジェクトでは、デザイン時に Worksheet ホスト項目をプロジェクトに追加できます。 アプリケーション レベルのプロジェクトでは、実行時に Worksheet ホスト項目を生成できます。

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

Excel のドキュメント レベルのプロジェクトを作成すると、Visual Studio によって 3 つの Worksheet ホスト項目がプロジェクト内に自動的に作成されます。 これらのワークシートの既定の名前は、Sheet1、Sheet2、および Sheet3 です。 既存のブックに基づいてプロジェクトを作成する場合は、そのブック内のワークシートの数に応じてホスト項目の数が決まります。

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

注意

スマート タグは、Excel 2010 および Word 2010 では使用されていません。 詳細については、「スマート タグの概要」を参照してください。

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

ドキュメント レベルのプロジェクトの場合は、デザイナーで新しいワークシートをブックに追加することにより、デザイン時に追加の Worksheet ホスト項目をプロジェクトに追加できます。

ワークシートの名前変更

ドキュメント レベルのプロジェクトでは、Visual Studio デザイナーでワークシートの名前を変更できますが、この場合はワークシートの表示名だけが変わります。 ワークシートのプログラム上の名前は既定の名前のままです。 [プロパティ] ウィンドウでワークシートの名前を変更すると、プログラム上の名前だけが変更されます。

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

ドキュメント レベルのプロジェクトでは、実行時に新しい Worksheet ホスト項目を作成することはできません。 実行時に新しい Excel ワークシートを作成すると、そのワークシートは Microsoft.Office.Interop.Excel.Worksheet 型になります。 これはホスト項目ではないため、ホスト コントロールや Windows フォーム コントロールを含めることはできません。 実行時に文書を作成する方法の詳細については、「方法 : 新しいワークシートをブックに追加する」を参照してください。

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

アプリケーション レベルのプロジェクトでは、Excel で開いている任意のワークシートの Worksheet ホスト項目を実行時に生成できます。 Worksheet ホスト項目を使用して、関連付けられたワークシートにコントロールおよびスマート タグを追加したり、Microsoft.Office.Interop.Excel.Worksheet オブジェクトでは使用できないイベントを処理したりできます。

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

参照

概念

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

実行時の Office ドキュメントへのコントロールの追加

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

Workbook ホスト項目

拡張オブジェクトによる Excel の自動化

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

その他の技術情報

Office 開発のサンプルとチュートリアル

Office ドキュメントのコントロール