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

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

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

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

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

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

この結果として完成したサンプルについては、「Office 開発のサンプルとチュートリアル」の Word コントロールのサンプルを参照してください。

必須コンポーネント

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

-

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

• Word 2007 または Word 2010。

プロジェクトの作成

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

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

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

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

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

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

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

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

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

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

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

   プロパティ	値
   名前	applyBoldFont
   テキスト	Bold

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

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

   プロパティ	値
   名前	applyItalicFont
   テキスト	イタリック体

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

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

   プロパティ	値
   名前	applyUnderlineFont
   テキスト	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 イベントに追加する必要があります。 イベント ハンドラーの作成方法については、「方法: 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 開発のサンプルとチュートリアル