チュートリアル : 初めての Word 用ドキュメントレベルのカスタマイズの作成

[アーティクル]
08/09/2011

この入門編のチュートリアルでは、Microsoft Office Word 用のドキュメントレベルのカスタマイズを作成する方法について説明します。この種のソリューションに作成した機能は、特定の文書が開いている場合にのみ使用できます。ドキュメントレベルのカスタマイズでは、文書が開いたときに新しいリボンタブを表示するなどの、アプリケーション全体の変更を行うことはできません。

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

このチュートリアルでは、次の作業について説明します。

Word 文書プロジェクトを作成する。
Visual Studio デザイナーでホストされるドキュメントにテキストを追加する。
Word のオブジェクトモデルを使用して、カスタマイズされた文書が開かれるときにテキストを追加するコードを記述する。
プロジェクトをビルドし、実行してテストする。
プロジェクトをクリーンアップして、不必要なビルドファイルおよびセキュリティ設定を開発用コンピューターから削除する。

注意

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

必須コンポーネント

このチュートリアルを実行するには、次のコンポーネントが必要です。

Microsoft Office 開発者ツールを含むエディションの Visual Studio 2010。 詳細については、「[Office ソリューションを開発できるようにコンピューターを構成する](bb398242\(v=vs.100\).md)」を参照してください。

Word 2007 または Word 2010。

プロジェクトの作成

Visual Studio で新しい Word 文書プロジェクトを作成するには

Visual Studio を起動します。
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
テンプレートペインで、[Visual C#] または [Visual Basic] を展開し、[Office] を展開します。
展開した [Office] ノードの下で、[2007] ノード (Word 2007 がインストールされている場合) または [2010] ノード (Word 2010 がインストールされている場合) を選択します。
プロジェクトテンプレートの一覧で、[Word 2007 ドキュメント] または [Word 2010 ドキュメント] を選択します。
[プロジェクト名] ボックスに「FirstDocumentCustomization」と入力します。
[OK] をクリックします。

Visual Studio Tools for Office プロジェクトウィザードが開きます。
[新規ドキュメントの作成] を選択し、[OK] をクリックします。

Visual Studio により FirstDocumentCustomization プロジェクトが作成され、FirstDocumentCustomization ドキュメントおよび ThisDocument コードファイルがプロジェクトに追加されます。 FirstDocumentCustomization ドキュメントが自動的にデザイナーで開かれます。

デザイナーでドキュメントを閉じ、再び開く

プロジェクトを開発しているときにデザイナーで開いていたドキュメントを意識的にまたは誤って閉じた場合は、そのドキュメントを再び開くことができます。

デザイナーでドキュメントを閉じ、再び開くには

デザイナーウィンドウの **[閉じる]**ボタン (X) をクリックしてドキュメントを閉じます。
ソリューションエクスプローラーで、ThisDocument コードファイルを右クリックし、[デザイナーの表示] をクリックします。

または

ソリューションエクスプローラーで ThisDocument コードファイルをダブルクリックします。

デザイナーを使用したドキュメントへのテキストの追加

デザイナーで開いたドキュメントを変更することで、カスタマイズのユーザーインターフェイス (UI: User Interface) をデザインできます。たとえば、テキスト、テーブル、または Word コントロールを追加できます。デザイナーを使用する方法の詳細については、「Visual Studio 環境における Office プロジェクト」を参照してください。

デザイナーを使用してドキュメントにテキストを追加するには

デザイナーで開いているドキュメントに次のテキストを入力します。

This text was added by using the designer.

プログラムによるドキュメントへのテキストの追加

次に、ThisDocument コードファイルにコードを追加します。この新しいコードでは、Word のオブジェクトモデルを使用して、ドキュメントに 2 番目の段落を追加します。 ThisDocument コードファイルには、次のコードが既定で含まれています。

ThisDocument クラスの部分定義。このクラスは、ドキュメントのプログラミングモデルを表し、Word のオブジェクトモデルへのアクセスを提供します。詳細については、「Document ホスト項目」および「Word オブジェクトモデルの概要」を参照してください。 ThisDocument クラスの残りの部分は、変更することができない非表示のコードファイルに定義されています。
ThisDocument_Startup イベントハンドラーおよび ThisDocument_Shutdown イベントハンドラー。これらのイベントハンドラーは、ドキュメントを開いたとき、または閉じたときに呼び出されます。これらのイベントハンドラーを使用して、ドキュメントが開いたときにはカスタマイズを初期化し、ドキュメントが閉じたときにはカスタマイズが使用したリソースをクリーンアップします。詳細については、「Office プロジェクトのイベント」を参照してください。

コードを使用してドキュメントに 2 番目の段落を追加するには

ソリューションエクスプローラーで、ThisDocument を右クリックし、[コードの表示] をクリックします。

Visual Studio でコードファイルが開かれます。
ThisDocument_Startup イベントハンドラーを次のコードで置き換えます。ドキュメントが開かれると、この新しいコードにより、2 番目の段落がドキュメントに追加されます。
```
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub
```
```
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}
```
注意

このコードでは、インデックス値 1 を使用して、Paragraphs プロパティ内の最初の段落にアクセスします。 Visual Basic や Visual C# ではインデックス番号が 0 から始まる配列が使用されますが、Word オブジェクトモデルのほとんどのコレクションでは、配列の下位のインデックスは 1 から始まります。詳細については、「Office ソリューションでの Visual Basic を使用したプログラミングと Visual C# を使用したプログラミング」を参照してください。

プロジェクトのテスト

文書をテストするには

F5 キーを押して、プロジェクトをビルドおよび実行します。

プロジェクトをビルドすると、コードはアセンブリにコンパイルされ、ドキュメントに関連付けられます。 Visual Studio は、ドキュメントおよびアセンブリのコピーをプロジェクトのビルド出力フォルダーに格納し、カスタマイズを実行できるように開発用コンピューター上のセキュリティ設定を行います。詳細については、「Office ソリューションビルド処理の概要」を参照してください。
次のテキストが文書に追加されることを確認します。

This text was added by using the designer.

This text was added by using code.
ドキュメントを閉じます。

プロジェクトのクリーンアップ

プロジェクトの開発が完了したら、ビルドプロセスによって作成されたビルド出力フォルダー内のファイルおよびセキュリティ設定を削除する必要があります。

開発用コンピューターから完成したプロジェクトをクリーンアップするには

Visual Studio で、[ビルド] メニューの [ソリューションのクリーン] をクリックします。

次の手順

Word 用の基本的なドキュメントレベルのカスタマイズを作成した後は、カスタマイズの開発方法の詳細について、以下のトピックを参照してください。

ドキュメントレベルのカスタマイズで実行できる一般的なプログラミングタスク : ドキュメントレベルのカスタマイズのプログラミング
Word 用のドキュメントレベルのカスタマイズに固有のプログラミングタスク : Word ソリューション
Word のオブジェクトモデルの使用 : Word オブジェクトモデルの概要
Word の UI のカスタマイズ (リボンへのカスタムタブの追加、独自の操作ウィンドウの作成など) : Office UI のカスタマイズ
Word オブジェクトモデルでは不可能なタスクをVisual Studio Tools for Office から提供される拡張 Word オブジェクトを使用して実行する (たとえば、文書でのマネージコントロールのホスト、Windows フォームデータバインディングモデルを使用した Word コントロールのデータへのバインド) : 拡張オブジェクトによる Word の自動化
Word 用のドキュメントレベルのカスタマイズのビルドとデバッグ : Office ソリューションのビルドとデバッグ
Word 用のドキュメントレベルのカスタマイズの配置 : Office ソリューションの配置