チュートリアル : CheckBox コントロールを使用したワークシート書式の変更

更新 : 2007 年 11 月

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

このチュートリアルでは、Microsoft Office Excel ワークシートでチェック ボックスを使用して、書式を変更する際の基本事項について説明します。Visual Studio Tools for Office を使用して、コードを作成し、プロジェクトに追加します。この結果を完全なサンプルとして参照するには、「Excel のコントロールのサンプル」を参照してください。

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

• ワークシートにテキストやコントロールを追加します。

• オプション選択時にテキストを書式設定します。

• プロジェクトをテストします。

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

前提条件

このチュートリアルを完了するための要件を次に示します。

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

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

プロジェクトの作成

この手順では、Visual Studio Tools for Office を使用して Excel ブック プロジェクトを作成します。

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

• My Excel Formatting という名前で Excel ブックのプロジェクトを作成します。[新規ドキュメントの作成] が選択されていることを確認します。詳細については、「方法 : Visual Studio Tools for Office プロジェクトを作成する」を参照してください。

  新しい Excel ブックが Visual Studio のデザイナに開かれ、[My Excel Formatting] プロジェクトがソリューション エクスプローラに追加されます。

ワークシートへのテキストとコントロールの追加

このチュートリアルでは、3 つの CheckBox コントロール、および NamedRange コントロール内のテキストが必要です。

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

1. ブックが Visual Studio のデザイナで開かれ、Sheet1 が開かれていることを確認します。

2. ツールボックスの [コモン コントロール] タブから CheckBox コントロールを [Sheet1] のセル B2 の内側または近辺にドラッグします。

3. [表示] メニューの [プロパティ] ウィンドウをクリックします。

4. [プロパティ] ウィンドウのオブジェクト名リスト ボックスに [Checkbox1] が表示されていることを確認し、次のプロパティを変更します。

   プロパティ	値
   [(Name)]	applyBoldFont
   Text	Bold

5. 2 番目のチェック ボックスをセル B4 の内部または近辺にドラッグし、次のプロパティを変更します。

   プロパティ	値
   [(Name)]	applyItalicFont
   Text	Italic

6. 3 番目のチェック ボックスをセル B6 の内部または近辺にドラッグし、次のプロパティを変更します。

   プロパティ	値
   [(Name)]	applyUnderlineFont
   Text	Underline

7. Ctrl キーを押しながら、3 つのチェック ボックス コントロールを選択します。

8. Excel のツール バーの [左揃え] をクリックし、[上下の間隔を均等にする] をクリックします。

   これで、3 つのチェック ボックス コントロールは、選択した最初のコントロールの位置に、上下の間隔を均等にして左詰めに配置されます。

   次に、NamedRange コントロールをワークシートにドラッグします。

   メモ :
   [名前ボックス] に「textFont」と入力しても NamedRange コントロールを追加できます。

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

1. ツールボックスの [Excel コントロール] タブから NamedRange コントロールをセル B9 にドラッグします。

2. 編集可能なテキスト ボックスに [$B$10] と表示され、セル B9 が選択されていることを確認します。選択されていない場合は、セル B9 をクリックして選択します。

3. [OK] をクリックします。

4. セル B9 は、NamedRange1 という名前の範囲になります。

   ワークシート上には範囲を示す表示はありませんが、セル B9 の選択時に NamedRange1 が [名前ボックス](左側のワークシートのすぐ上) に表示されます。

5. [プロパティ] ウィンドウのオブジェクト名リスト ボックスに [NamedRange1] が表示されていることを確認し、次のプロパティを変更します。

   プロパティ	値
   [(Name)]	textFont
   [Value2]	チェック ボックスをクリックしてこのテキストの書式を変更します。

次に、オプションの選択時にテキストに書式を設定するコードを記述します。

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

ここでは、ユーザーが書式設定オプションを選択したときにワークシート内のテキストの書式が変更されるようにするコードを記述します。

チェック ボックス選択時に書式を変更するには

1. [Sheet1] を右クリックし、ショートカット メニューの [コードの表示] をクリックします。

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

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

   private void applyBoldFont_Click(object sender, EventArgs e)
   {
       this.textFont.Font.Bold = this.applyBoldFont.Checked;
   }
   

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

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

   private void applyItalicFont_Click(object sender, EventArgs e)
   {
       this.textFont.Font.Italic = this.applyItalicFont.Checked;
   }
   

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

   Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyUnderlineFont.Click
   
       If Me.applyUnderlineFont.Checked Then
           Me.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleSingle
       Else
           Me.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleNone
       End If
   End Sub
   

   private void applyUnderlineFont_Click(object sender, EventArgs e)
   {
       if (this.applyUnderlineFont.Checked == true)
       {
           this.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleSingle;
       }
       else
       {
           this.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleNone;
       }
   }
   

5. 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. テキストの書式が正しく設定されることを確認します。

次の手順

このチュートリアルでは、Excel ワークシートでのチェック ボックスの使用とテキストの書式設定に関する基本事項について説明します。次に行う作業は以下のとおりです。

• プロジェクトを配置します。詳細については、「Office ソリューションの配置」を参照してください。

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

参照

概念

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

NamedRange コントロール

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