チュートリアル : CheckBox コントロールを使用したドキュメント書式の変更

更新 : 2007 年 11 月

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

このチュートリアルでは、Microsoft Office Word のドキュメント レベルのカスタマイズで Windows フォーム コントロールを使用してテキストの書式設定を変更する方法を示します。

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

• デザイン時におけるドキュメント レベルのプロジェクトの文書へのテキストおよびコントロールの追加

• オプション選択時のテキストの書式設定

結果を、サンプルの実行結果として参照するには、「Word のコントロールのサンプル」を参照してください。

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

前提条件

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

• Visual Studio Tools for Office (Visual Studio 2008 Professional および Visual Studio Team System のオプションの要素)

• Microsoft Office Word 2003 または Microsoft Office Word 2007

ここに挙げた Visual Studio のバージョンでは、Visual Studio Tools for Office が既定でインストールされます。インストールされているかどうかを確認する方法については、「Visual Studio Tools for Office のインストール」を参照してください。

プロジェクトの作成

まず、Word 文書プロジェクトを作成します。

新しいプロジェクトを作成するには

• My Word Formatting という名前の Word 文書プロジェクトを作成します。ウィザードで、[新規ドキュメントの作成] をクリックします。

  詳細については、「方法 : Visual Studio Tools for Office プロジェクトを作成する」を参照してください。

  新しい Word 文書がデザイナで開き、My Word Formatting プロジェクトがソリューション エクスプローラに追加されます。

テキストとコントロールの Word 文書への追加

このチュートリアルでは、Word 文書に 3 つのチェック ボックスを追加し、Bookmark コントロールにテキストを指定します。3 つのチェック ボックスは、ユーザーにテキストの書式設定オプションを提供します。

3 つのチェック ボックスを追加するには

1. Visual Studio デザイナで文書が開いていることを確認します。

2. [ツールボックス] の [コモン コントロール] タブから 1 つ目の CheckBox コントロールを文書にドラッグします。

3. [プロパティ] ウィンドウで、次のプロパティを変更します。

   プロパティ	値
   Name	applyBoldFont
   Text	Bold

4. Enter キーを押して、1 番目のチェック ボックスの下にカーソルを移動します。

5. 文書の ApplyBoldFont チェック ボックスの下に 2 つ目のチェック ボックスを追加し、次のプロパティを変更します。

   プロパティ	値
   Name	applyItalicFont
   Text	Italic

6. Enter キーを押して、2 番目のチェック ボックスの下にカーソルを移動します。

7. 文書の ApplyItalicFont チェック ボックスの下に 3 つ目のチェック ボックスを追加し、次のプロパティを変更します。

   プロパティ	値
   Name	applyUnderlineFont
   Text	Underline

テキストと Bookmark コントロールを追加するには

1. チェック ボックス コントロールの下にカーソルを移動し、次のテキストを入力します。

   このテキストの書式を変更するには、チェック ボックスをクリックします。

2. [ツールボックス] の [Word コントロール] タブから Bookmark コントロールを文書にドラッグします。

   [ブックマーク コントロールの追加] ダイアログ ボックスが表示されます。

3. 文書に追加するテキストを選択し、[OK] をクリックします。

   Bookmark1 という名前の Bookmark コントロールが、文書内で選択されているテキストに追加されます。

4. [プロパティ] ウィンドウで、[(名前)] プロパティの値を fontText に変更します。

次に、チェック ボックスがオンまたはオフにされたときにテキストの書式を設定するコードを記述します。

チェック ボックスのオンまたはオフ時のテキストの書式設定

ユーザーが書式指定のオプションを選択したときに、文書内のテキストの書式を変更します。

チェック ボックスがオンにされたときに書式を変更するには

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

2. C# の場合のみ、次の定数を ThisDocument クラスに追加します。

   const int WordTrue = -1;
   const int WordFalse = 0;
   

3. applyBoldFont チェック ボックスの Click イベント ハンドラに次のコードを追加します。

   Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyBoldFont.Click
   
       Me.fontText.Bold = Me.applyBoldFont.Checked
   End Sub
   

   private void applyBoldFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyBoldFont.Checked == true)
       {
           this.fontText.Bold = WordTrue;
       }
       else
       {
           this.fontText.Bold = WordFalse;
       }
   }
   

4. applyItalicFont チェック ボックスの Click イベント ハンドラに次のコードを追加します。

   Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyItalicFont.Click
   
       Me.fontText.Italic = Me.applyItalicFont.Checked
   End Sub
   

   private void applyItalicFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyItalicFont.Checked == true)
       {
           this.fontText.Italic = WordTrue;
       }
       else
       {
           this.fontText.Italic = WordFalse;
       }
   }
   

5. applyUnderlineFont チェック ボックスの Click イベント ハンドラに次のコードを追加します。

   Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyUnderlineFont.Click
   
       If Me.applyUnderlineFont.Checked Then
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle
       Else
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone
       End If
   End Sub
   

   private void applyUnderlineFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyUnderlineFont.Checked == true)
       {
           this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
       }
       else
       {
           this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
       }
   }
   

6. C# では、次に示すように、テキスト ボックスのイベント ハンドラを Startup イベントに追加する必要があります。イベント ハンドラの作成方法については、「方法 : Visual Studio Tools for Office でイベント ハンドラを作成する」を参照してください。

   this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
   this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
   this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
   

アプリケーションのテスト

文書をテストして、チェック ボックスをオンまたはオフにしたときにテキストの書式が正しく設定されることを確認できます。

文書をテストするには

1. F5 キーを押してプロジェクトを実行します。

2. チェック ボックスをオンまたはオフにします。

3. テキストの書式が正しく設定されることを確認します。

次の手順

このチュートリアルでは、Word 文書でチェック ボックスを使用して、プログラムからテキストの書式を変更する際の基本事項について説明します。次に行う作業は以下のとおりです。

• ボタンを使用したテキスト ボックスへのデータの読み込み。詳細については、「チュートリアル : ボタンを使用して文書内のテキスト ボックスにテキストを表示する方法」を参照してください。

• オプション ボタンを使用したグラフのスタイルの選択。詳細については、「チュートリアル : オプション ボタンを使用してドキュメントのグラフを更新する方法」を参照してください。

参照

概念

Word を使用したチュートリアル

NamedRange コントロール

Office ドキュメントでの Windows フォーム コントロールの制限事項

その他の技術情報

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