C# テキストボックスにスクロールバーを表示する

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

2024年9月14日

Windowsフォームアプリケーションを開発していると、テキストボックスに大量のテキストを表示したり、ユーザーに長文の入力を求めたりする場面がよくあります。そんな時に便利なのが、スクロールバーです。スクロールバーを追加することで、限られたスペース内で大量のテキストを効率的に扱うことができます。この記事では、C#を使ってテキストボックスにスクロールバーを表示する方法を、初心者にも分かりやすく解説します。

テキストボックスにスクロールバーを追加する基本的な方法

テキストボックスにスクロールバーを追加するには、主に以下の2つのプロパティを設定します：

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

以下に、基本的なコード例を示します：

using System;
using System.Windows.Forms;

public partial class Form1 : Form
{
    private TextBox scrollableTextBox;

    public Form1()
    {
        InitializeComponent();
        CreateScrollableTextBox();
    }

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

        this.Controls.Add(scrollableTextBox);

        // テキストボックスにサンプルテキストを追加
        scrollableTextBox.Text = "これはスクロール可能なテキストボックスです。\r\n" +
                                 "長いテキストを入力しても、\r\n" +
                                 "スクロールバーを使って\r\n" +
                                 "全体を確認することができます。\r\n" +
                                 "このように、複数行の\r\n" +
                                 "テキストを扱う際に\r\n" +
                                 "とても便利です。";
    }
}

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

Multiline = true を設定することで、テキストボックスが複数行のテキストを表示できるようになります。
ScrollBars = ScrollBars.Vertical を設定して、縦方向のスクロールバーを追加しています。
Size プロパティでテキストボックスのサイズを指定しています。これにより、表示領域が限定され、スクロールバーの必要性が生まれます。

スクロールバーのカスタマイズ

ScrollBars プロパティには以下の4つの選択肢があります：

ScrollBars.None: スクロールバーを表示しません。
ScrollBars.Horizontal: 横方向のスクロールバーのみを表示します。
ScrollBars.Vertical: 縦方向のスクロールバーのみを表示します。
ScrollBars.Both: 縦方向と横方向の両方のスクロールバーを表示します。

例えば、両方向のスクロールバーを表示したい場合は、以下のように設定します：

scrollableTextBox.ScrollBars = ScrollBars.Both;

スクロールバーの動的な制御

場合によっては、プログラムの実行中にスクロールバーの表示/非表示を切り替えたいことがあります。以下は、ボタンクリックでスクロールバーの表示を切り替える例です：

private Button toggleButton;

private void CreateToggleButton()
{
    toggleButton = new Button
    {
        Location = new System.Drawing.Point(10, 220),
        Size = new System.Drawing.Size(200, 30),
        Text = "スクロールバーの表示/非表示"
    };

    toggleButton.Click += ToggleButton_Click;
    this.Controls.Add(toggleButton);
}

private void ToggleButton_Click(object sender, EventArgs e)
{
    if (scrollableTextBox.ScrollBars == ScrollBars.Vertical)
    {
        scrollableTextBox.ScrollBars = ScrollBars.None;
    }
    else
    {
        scrollableTextBox.ScrollBars = ScrollBars.Vertical;
    }
}

このコードを追加することで、ボタンをクリックするたびにスクロールバーの表示/非表示が切り替わります。