RichTextBox

[C#] RichTextBoxでの文字数制限の設定方法

2025-01-18更新日: 2025-01-18

C#のRichTextBoxで文字数制限を設定するには、MaxLengthプロパティを使用します。

このプロパティに整数値を設定することで、入力可能な最大文字数を指定できます。

例えば、richTextBox1.MaxLength = 100;とすることで、richTextBox1に入力できる文字数を100文字に制限できます。

ただし、MaxLengthプロパティはRichTextBoxの標準機能ではなく、TextBoxの機能です。

そのため、RichTextBoxで文字数制限を実現するには、テキスト変更イベントで手動で制御する必要があります。

具体的には、TextChangedイベントでテキストの長さをチェックし、制限を超えた場合にテキストを切り詰めるなどの処理を行います。

目次から探す

RichTextBoxでの文字数制限の実装方法
応用例
まとめ

RichTextBoxでの文字数制限の実装方法

MaxLengthプロパティの利用

MaxLengthプロパティの概要

RichTextBoxコントロールには、MaxLengthプロパティが用意されています。

このプロパティを使用することで、ユーザーが入力できる文字数を簡単に制限することができます。

MaxLengthプロパティに設定した値を超える文字は入力できなくなります。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        richTextBox1.MaxLength = 100; // 最大文字数を100に設定
    }
}

richTextBox1に100文字まで入力可能です。

MaxLengthプロパティの制限事項

MaxLengthプロパティは、RichTextBoxにおいては、全体の文字数に対してのみ制限をかけます。

特定の行や段落に対しての制限は行えません。

また、MaxLengthは、改行や空白もカウントしますので、注意が必要です。

TextChangedイベントを利用した制限

TextChangedイベントの概要

TextChangedイベントは、RichTextBoxの内容が変更されたときに発生します。

このイベントを利用することで、文字数制限をより柔軟に実装することができます。

例えば、特定の条件に基づいて文字数を制限することが可能です。

イベントハンドラの実装例

以下のコードは、TextChangedイベントを使用して、文字数が50を超えた場合に警告メッセージを表示する例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        richTextBox1.TextChanged += RichTextBox1_TextChanged; // イベントハンドラの登録
    }
    private void RichTextBox1_TextChanged(object sender, EventArgs e)
    {
        if (richTextBox1.Text.Length > 50) // 50文字を超えた場合
        {
            MessageBox.Show("文字数は50文字までです。"); // 警告メッセージを表示
        }
    }
}

richTextBox1に50文字を超えると警告が表示されます。

カスタムメソッドによる制限

カスタムメソッドの必要性

MaxLengthプロパティやTextChangedイベントを使用する方法では、特定の条件に基づいた複雑な制限を実装することが難しい場合があります。

そのため、カスタムメソッドを作成して、より柔軟な文字数制限を実現することができます。

実装例とその効果

以下のコードは、特定の条件に基づいて文字数を制限するカスタムメソッドの例です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        richTextBox1.TextChanged += RichTextBox1_TextChanged; // イベントハンドラの登録
    }
    private void RichTextBox1_TextChanged(object sender, EventArgs e)
    {
        LimitTextLength(100); // 最大文字数を100に制限
    }
    private void LimitTextLength(int maxLength)
    {
        if (richTextBox1.Text.Length > maxLength) // 最大文字数を超えた場合
        {
            richTextBox1.Text = richTextBox1.Text.Substring(0, maxLength); // 超えた分を削除
            richTextBox1.SelectionStart = richTextBox1.Text.Length; // カーソルを最後に移動
        }
    }
}

richTextBox1に100文字を超えると、自動的に超えた分が削除されます。

応用例

複数のRichTextBoxでの文字数制限

複数のRichTextBoxコントロールに対して同じ文字数制限を適用する場合、共通のメソッドを作成して、各RichTextBoxのTextChangedイベントに登録することができます。

以下の例では、2つのRichTextBoxに対して最大文字数を設定しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        richTextBox1.TextChanged += RichTextBox_TextChanged; // イベントハンドラの登録
        richTextBox2.TextChanged += RichTextBox_TextChanged; // もう一つのRichTextBoxにも登録
    }
    private void RichTextBox_TextChanged(object sender, EventArgs e)
    {
        LimitTextLength(100, sender as RichTextBox); // 最大文字数を100に制限
    }
    private void LimitTextLength(int maxLength, RichTextBox richTextBox)
    {
        if (richTextBox.Text.Length > maxLength) // 最大文字数を超えた場合
        {
            richTextBox.Text = richTextBox.Text.Substring(0, maxLength); // 超えた分を削除
            richTextBox.SelectionStart = richTextBox.Text.Length; // カーソルを最後に移動
        }
    }
}

richTextBox1とrichTextBox2の両方に100文字の制限が適用されます。

特定の条件下での文字数制限変更

特定の条件に基づいて文字数制限を動的に変更することも可能です。

例えば、あるチェックボックスがオンのときは文字数を200に、オフのときは100に設定する場合の例を示します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        richTextBox1.TextChanged += RichTextBox1_TextChanged; // イベントハンドラの登録
        checkBox1.CheckedChanged += CheckBox1_CheckedChanged; // チェックボックスのイベントハンドラ
    }
    private void CheckBox1_CheckedChanged(object sender, EventArgs e)
    {
        // チェックボックスの状態に応じて文字数制限を変更
        LimitTextLength(checkBox1.Checked ? 200 : 100);
    }
    private void RichTextBox1_TextChanged(object sender, EventArgs e)
    {
        LimitTextLength(checkBox1.Checked ? 200 : 100); // 現在の制限を適用
    }
    private void LimitTextLength(int maxLength)
    {
        if (richTextBox1.Text.Length > maxLength) // 最大文字数を超えた場合
        {
            richTextBox1.Text = richTextBox1.Text.Substring(0, maxLength); // 超えた分を削除
            richTextBox1.SelectionStart = richTextBox1.Text.Length; // カーソルを最後に移動
        }
    }
}

チェックボックスがオンのときはrichTextBox1に200文字まで入力可能、オフのときは100文字までです。

ユーザーへの警告メッセージの表示

文字数制限を超えた場合にユーザーに警告メッセージを表示することも重要です。

以下の例では、文字数が制限を超えた際にメッセージボックスで警告を表示します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        richTextBox1.TextChanged += RichTextBox1_TextChanged; // イベントハンドラの登録
    }
    private void RichTextBox1_TextChanged(object sender, EventArgs e)
    {
        int maxLength = 100; // 最大文字数を100に設定
        if (richTextBox1.Text.Length > maxLength) // 最大文字数を超えた場合
        {
            MessageBox.Show("文字数は100文字までです。", "警告", MessageBoxButtons.OK, MessageBoxIcon.Warning); // 警告メッセージを表示
            LimitTextLength(maxLength); // 超えた分を削除
        }
    }
    private void LimitTextLength(int maxLength)
    {
        richTextBox1.Text = richTextBox1.Text.Substring(0, maxLength); // 超えた分を削除
        richTextBox1.SelectionStart = richTextBox1.Text.Length; // カーソルを最後に移動
    }
}