Share via

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

  • [アーティクル]

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

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

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

  • デザイン時に、ドキュメント レベルのプロジェクト内のドキュメントにテキストとコントロールを追加する。

  • オプションが選択されたときにテキストを書式設定する。

    完全なサンプルの結果を確認するには、「Office 開発のサンプルとチュートリアル」にある Word コントロールのサンプルを参照してください。

    Note

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

必須コンポーネント

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

プロジェクトを作成する

最初に、Word 文書のプロジェクトを作成します。

新しいプロジェクトの作成

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

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

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

Word 文書にテキストとコントロールを追加する

このチュートリアルでは、3 つのチェック ボックスと、Bookmark コントロール内のテキストを Word 文書に追加します。 これらのチェック ボックスには、テキストを書式設定するためのオプションがユーザー向けに表示されます。

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

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

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

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

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

  4. Enter キーを押して、1 つ目のチェック ボックスの下に挿入ポイントを移動します。

  5. ApplyBoldFont チェック ボックスの下のドキュメントに 2 つ目のチェック ボックスを追加し、次のプロパティを変更します。

    プロパティ 値
    名前 applyItalicFont
    テキスト 斜体

  6. Enter キーを押して、2 つ目のチェック ボックスの下に挿入ポイントを移動します。

  7. ApplyItalicFont チェック ボックスの下のドキュメントに 3 つ目のチェック ボックスを追加し、次のプロパティを変更します。

    プロパティ 値
    名前 applyUnderlineFont
    テキスト 下線

テキストとブックマーク コントロールを追加する

  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 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 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 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 文書でチェック ボックスを使用して、テキストの書式をプログラムによって変更するための基本的な方法について説明しました。 ここでは、次の作業を行います。

関連するコンテンツ