C# TextBoxに複数行のメッセージを表示する

このサイトはプロモーションを含みます

2024年9月13日

C#でWindowsフォームアプリケーションを開発する際、ユーザーに複数行のメッセージや長文のテキストを表示する必要がしばしば生じます。TextBoxコントロールは、このような目的に適しており、適切に設定することで複数行のテキストを効果的に表示できます。この記事では、C#を使ってTextBoxに複数行のメッセージを表示する方法を、初心者にも分かりやすく解説します。

TextBoxを複数行表示に設定する

TextBoxを複数行表示にするには、主に以下の2つのプロパティを設定する必要があります：

Multiline プロパティ
ScrollBars プロパティ

以下に、これらのプロパティを設定し、複数行のメッセージを表示するための基本的なコード例を示します：

using System;
using System.Windows.Forms;

public partial class Form1 : Form
{
    private TextBox multilineTextBox;

    public Form1()
    {
        InitializeComponent();
        CreateMultilineTextBox();
        DisplayMultilineMessage();
    }

    private void CreateMultilineTextBox()
    {
        multilineTextBox = new TextBox
        {
            Multiline = true,
            ScrollBars = ScrollBars.Vertical,
            Location = new System.Drawing.Point(10, 10),
            Size = new System.Drawing.Size(300, 200)
        };

        this.Controls.Add(multilineTextBox);
    }

    private void DisplayMultilineMessage()
    {
        string message = "これは1行目です。\r\n" +
                         "これは2行目です。\r\n" +
                         "これは3行目です。\r\n" +
                         "これは長い文章の例です。TextBoxに複数行のテキストを表示することができます。";

        multilineTextBox.Text = message;
    }
}

このコードの主なポイントは以下の通りです：

Multiline = true を設定することで、TextBoxが複数行のテキストを表示できるようになります。
ScrollBars = ScrollBars.Vertical を設定することで、テキストが TextBox の表示領域を超えた場合に縦スクロールバーが表示されます。
Location と Size プロパティを使用して、TextBox の位置とサイズを設定しています。
\r\n を使用して改行を挿入しています。これは Windows での標準的な改行コードです。

環境に依存しない改行の使用

異なる環境（Windows、Mac、Linux など）で動作するアプリケーションを開発する場合は、Environment.NewLine を使用することをおすすめします。これにより、実行環境に適した改行コードが自動的に使用されます。

private void DisplayMultilineMessage()
{
    string message = $"これは1行目です。{Environment.NewLine}" +
                     $"これは2行目です。{Environment.NewLine}" +
                     $"これは3行目です。{Environment.NewLine}" +
                     "これは長い文章の例です。TextBoxに複数行のテキストを表示することができます。";

    multilineTextBox.Text = message;
}

TextBox のプロパティをさらにカスタマイズ

TextBox の外観や動作をさらにカスタマイズするために、以下のようなプロパティを設定することができます：

multilineTextBox.ReadOnly = true; // テキストの編集を禁止
multilineTextBox.WordWrap = true; // 長い行を折り返して表示
multilineTextBox.Font = new System.Drawing.Font("MS Gothic", 12F); // フォントの設定
multilineTextBox.ForeColor = System.Drawing.Color.Blue; // テキストの色を設定

これらの設定により、TextBox の使用目的に合わせて、より適切な表示や動作を実現することができます。