次の方法で共有


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

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

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

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

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

  • オプションが選択されている場合のテキストの書式設定。

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

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

[前提条件]

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

プロジェクトを作成する

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

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

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

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

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

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

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

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

  1. Visual Studio デザイナーでドキュメントが開かれていることを確認します。

  2. ツールボックスの [共通コントロール] タブから、最初のCheckBox コントロールをドキュメントにドラッグします。

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

    プロパティ 価値
    名前 applyBoldFont
    Text Bold
  4. 最初のチェック ボックスの下にカーソルを移動するには、 Enter キーを押します。

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

    プロパティ 価値
    名前 applyItalicFont
    Text Italic
  6. 2 番目のチェック ボックスの下にカーソルを移動するには、 Enter キーを押します。

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

    プロパティ 価値
    名前 applyUnderlineFont
    Text アンダーライン

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

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

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

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

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

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

    Bookmark という名前の コントロールが、ドキュメント内の選択したテキストに追加されます。

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

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

チェック ボックスがオンまたはオフのときにテキストの書式を設定する

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

チェック ボックスがオンのときに書式を変更する

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

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

    const int WordTrue = -1;
    const int WordFalse = 0;
    
  3. Click チェック ボックスのapplyBoldFont イベント ハンドラーに次のコードを追加します。

    private void applyBoldFont_Click(object sender, System.EventArgs e)
    {
        if (this.applyBoldFont.Checked == true)
        {
            this.fontText.Bold = WordTrue;
        }
        else
        {
            this.fontText.Bold = WordFalse;
        }
    }
    
  4. Click チェック ボックスのapplyItalicFont イベント ハンドラーに次のコードを追加します。

    private void applyItalicFont_Click(object sender, System.EventArgs e)
    {
        if (this.applyItalicFont.Checked == true)
        {
            this.fontText.Italic = WordTrue;
        }
        else
        {
            this.fontText.Italic = WordFalse;
        }
    }
    
  5. Click チェック ボックスのapplyUnderlineFont イベント ハンドラーに次のコードを追加します。

    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 文書でのチェック ボックスの使用とプログラムによるテキスト書式の変更の基本について説明します。 次に来るタスクを次に示します。