C# Control.Leave イベント

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

2024年9月14日

Windowsフォームアプリケーションを開発する際、ユーザーの操作に応じて適切にデータを処理することは非常に重要です。特に、ユーザーがあるコントロールから別のコントロールに移動する瞬間を捉えて処理を行いたい場面がよくあります。そんな時に活躍するのが、C#のControl.Leaveイベントです。この記事では、Control.Leaveイベントの基本的な使い方と活用例を、初心者にも分かりやすく解説します。

Control.Leaveイベントとは

Control.Leaveイベントは、フォーカスがあるコントロールから別のコントロールに移動する直前に発生します。このイベントを利用することで、ユーザーが入力を終えた瞬間に値の検証やデータの保存などの処理を行うことができます。

基本的な使い方

以下に、TextBoxのLeaveイベントを使用する基本的なコード例を示します：

using System;
using System.Windows.Forms;

public partial class Form1 : Form
{
    private TextBox nameTextBox;
    private Label messageLabel;

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

    private void CreateControls()
    {
        nameTextBox = new TextBox
        {
            Location = new System.Drawing.Point(10, 10),
            Size = new System.Drawing.Size(200, 20)
        };

        messageLabel = new Label
        {
            Location = new System.Drawing.Point(10, 40),
            Size = new System.Drawing.Size(200, 20),
            Text = ""
        };

        // Leaveイベントハンドラを登録
        nameTextBox.Leave += NameTextBox_Leave;

        this.Controls.Add(nameTextBox);
        this.Controls.Add(messageLabel);
    }

    private void NameTextBox_Leave(object sender, EventArgs e)
    {
        if (string.IsNullOrWhiteSpace(nameTextBox.Text))
        {
            messageLabel.Text = "名前を入力してください。";
        }
        else
        {
            messageLabel.Text = $"こんにちは、{nameTextBox.Text}さん！";
        }
    }
}

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

nameTextBox.Leave += NameTextBox_Leave; で、TextBoxのLeaveイベントにイベントハンドラを登録しています。
NameTextBox_Leave メソッド内で、ユーザーがTextBoxから離れた時の処理を定義しています。
TextBoxの内容に応じて、メッセージを表示しています。

Leaveイベントの活用例

入力値の検証 Leaveイベントは、ユーザーが入力を終えた直後に値を検証するのに最適です。

private void AgeTextBox_Leave(object sender, EventArgs e)
{
    if (!int.TryParse(ageTextBox.Text, out int age))
    {
        MessageBox.Show("有効な年齢を入力してください。");
        ageTextBox.Focus(); // フォーカスを戻す
    }
}

2.データの自動保存
ユーザーがコントロールを離れる際に、入力されたデータを自動的に保存することができます。

private void NotesTextBox_Leave(object sender, EventArgs e)
{
    SaveNotes(notesTextBox.Text);
}

private void SaveNotes(string notes)
{
    // ここにデータを保存するコードを書く
    Console.WriteLine($"メモを保存しました: {notes}");
}

注意点

Leaveイベントは、コントロールがフォーカスを失う直前に発生します。そのため、このイベント内でフォーカスを元のコントロールに戻す処理を行うと、予期せぬ動作を引き起こす可能性があります。
フォームが閉じられる際にもLeaveイベントが発生することがあるため、必要に応じて適切なチェックを行ってください。