Word テンプレートプロジェクト テンプレート
更新 : 2007 年 11 月
対象 |
|---|
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。 プロジェクトの種類
Microsoft Office のバージョン
詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。 |
Visual Basic および Visual C# の Word テンプレート プロジェクト テンプレートには、新規または既存の Microsoft Office Word テンプレートに基づいたソリューション用の基盤が用意されています。Word 2003 テンプレートと Word 2007 テンプレートには、さまざまなプロジェクト テンプレートがあります。プロジェクト テンプレートによって、必要なアセンブリ参照、ファイル、およびソリューションの開始点として生成されたコードが自動的に追加されます。
マネージ コード拡張機能を参照する Word テンプレートは、グローバル アドインとして使用できません。テンプレートが Word の Startup ディレクトリから読み込まれた場合、アセンブリは呼び出されません。詳細については、「グローバル テンプレートと Excel アドイン (.xla ファイル) に関する制限事項」を参照してください。
ソリューションのコンパイル後に Visual Studio の外部でテンプレートを編集用に開いた場合は、そのテンプレートから新規文書を作成したときと同じように、テンプレートのコードが実行されます。コードの内容によっては、テンプレートを開いて編集を始める前にテンプレートが変更されてしまうことがあります。コードが実行されないようにするには、テンプレートを開くときに Shift キーを押したままにします。
.gif "メモ") メモ : |
|---|
次の一覧にあるファイルおよび参照の一部は、既定で非表示になっています。これらを表示するには、ソリューション エクスプローラのツール バーの [すべてのファイルを表示] をクリックします。さらに、次の一覧に示したもの以外にも、数多くの Visual Studio プロジェクト テンプレートに共通するファイルおよび参照がいくつかあります。 |
ファイル
Visual Studio Tools for Office は、Word 2003 テンプレート プロジェクトおよび Word 2007 テンプレート プロジェクトに次の可視ファイルを生成します。
Document Name.dot - プロジェクト内の Word テンプレートを表します。文書のデザイン サーフェイスとコード ファイルが含まれます。
ThisDocument (Visual Basic の場合は .vb ファイル、Visual C# の場合は .cs ファイル) - デザイン サーフェイスとコード ファイルを含んでいる文書。詳細については、「Document ホスト項目」を参照してください。
| メモ : |
|---|
文書、ブック、またはワークシートの背後にあるコード ファイルに追加のクラスを追加することはできません。作成するクラスを格納するための新しいファイルをプロジェクトに追加する必要があります。 |
Visual Studio Tools for Office は、Word 2007 テンプレート プロジェクトを作成するときに次の追加ファイルも生成します。
- Project Name_TemporaryKey.pfx - 開発時にプロジェクトのアプリケーション マニフェストと配置マニフェストへの署名に使用できる一時的な証明書。詳細については、「Office ソリューションへの信頼の付与 (2007 システム)」および「Office ソリューションにおけるセキュリティ (2007 システム)」を参照してください。
隠しファイル
Visual Studio Tools for Office は、複数の隠しファイルを生成します。これらのファイルを手動で修正しないでください。これらのファイルはプロジェクトが変更されると再生成され、手動で加えた修正は維持されません。
Visual Studio Tools for Office は、次の隠しファイルを生成します。
ThisDocument.Designer.xml - 文書内のプログラミング可能なオブジェクトに関する読み取り専用の宣言表現。
ThisDocument.Designer (.vb ファイルまたは .cs ファイル) - 文書内のオブジェクトのヘルパー実装を含んでいる読み取り専用のコード ファイル。オブジェクトを正しくインスタンス化するためのコードが含まれます。
Document Name.Designer.xml - 既定で Visual Studio Tools for Office に含まれていないプログラミング可能なオブジェクト (カスタム コントロールなど) に関する読み取り専用の宣言表現。このファイルは、文書にカスタム コントロールを追加すると生成されます。
Document Name.Designer (.vb ファイルまたは .cs ファイル) - カスタム コントロールのヘルパー実装を含んでいる読み取り専用のコード ファイル。このファイルは、文書にカスタム コントロールを追加すると生成されます。
テンプレート コード
プロジェクト テンプレートのコード ファイルには、次のイベント ハンドラが含まれています。詳細については、「Visual Studio Tools for Office プロジェクトのイベント」を参照してください。
ThisDocument_Startup
ThisDocument_Startup は、Document.Startup イベントを処理します。ソリューションが実行され、アセンブリ内のすべての初期化コードが実行された後に、発生するイベントです。このイベント ハンドラを使用して、ソリューションを初期化するコードを実行します。
ThisDocument_Shutdown
ThisDocument_Shutdown は、Document.Shutdown イベントを処理します。このイベントは、コードが読み込まれているアプリケーション ドメインをアンロードするときに発生します。
リファレンス
Visual Studio Tools for Office では、一連のアセンブリ参照が Word テンプレート プロジェクト内で自動的に作成されます。これらの参照には、次のアセンブリが含まれます。
Visual Studio Tools for Office ランタイム内のアセンブリ。これらのアセンブリの詳細については、「Visual Studio Tools for Office Runtime の概要」を参照してください。
共有 Microsoft Office コンポーネントおよび Word のプライマリ相互運用機能アセンブリ。詳細については、「Office プライマリ相互運用機能アセンブリ」を参照してください。
Visual Studio Tools for Office ソリューションの開発時に使用される .NET Framework アセンブリ。
参照
処理手順
方法 : Visual Studio Tools for Office プロジェクトを作成する