キーボード

[C#] キー入力イベント(KeyDown,KeyPress,KeyUp)の使い方

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

C#でキー入力イベントを扱う際には、主にKeyDown、KeyPress、KeyUpの3つのイベントを使用します。

KeyDownはキーが押された瞬間に発生し、キーのコードを取得できます。

KeyPressは文字キーが押されたときに発生し、文字情報を取得するのに適しています。

KeyUpはキーが離された瞬間に発生し、押されたキーの終了を検知します。

これらのイベントは通常、フォームやコントロールに対して設定し、イベントハンドラを用いて処理を記述します。

例えば、KeyDownイベントではe.KeyCodeを使って特定のキーが押されたかを確認できます。

目次から探す

キー入力イベントの概要

C#のWindowsフォームアプリケーションでは、ユーザーからのキー入力を処理するために、主に3つのイベントが用意されています。

これらは、KeyDown、KeyPress、KeyUpです。

KeyDownイベントはキーが押された瞬間に発生し、KeyPressイベントは文字が入力された際に発生します。

最後に、KeyUpイベントはキーが離されたときに発生します。

これらのイベントを適切に利用することで、ユーザーインターフェースをよりインタラクティブにし、ユーザーの操作に応じた動作を実現できます。

各イベントの特性を理解し、効果的に活用することが重要です。

KeyDownイベントの使い方

KeyDownイベントの基本的な設定方法

KeyDownイベントを使用するには、まずフォームにイベントハンドラを追加します。

以下のコードは、KeyDownイベントを設定する基本的な方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.KeyDown += new KeyEventHandler(MyForm_KeyDown);
    }
    private void MyForm_KeyDown(object sender, KeyEventArgs e)
    {
        // キーが押されたときの処理をここに記述
    }
}

このコードでは、MyFormクラスのコンストラクタ内でKeyDownイベントに対するハンドラを登録しています。

KeyCodeプロパティの利用

KeyEventArgsクラスのKeyCodeプロパティを使用することで、押されたキーを特定できます。

以下の例では、特定のキーが押されたときにメッセージボックスを表示します。

private void MyForm_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter) // Enterキーが押された場合
    {
        MessageBox.Show("Enterキーが押されました。");
    }
}

特定のキーを検出する方法

特定のキーを検出するためには、KeyCodeプロパティを使用して、押されたキーが何であるかを確認します。

以下の例では、Aキーが押されたときに処理を行います。

private void MyForm_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.A) // Aキーが押された場合
    {
        MessageBox.Show("Aキーが押されました。");
    }
}

修飾キーの検出

修飾キー(Shift、Ctrl、Altなど)を検出するには、KeyEventArgsのModifiersプロパティを使用します。

以下の例では、CtrlキーとAキーが同時に押された場合の処理を示します。

private void MyForm_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.A && e.Modifiers == Keys.Control) // Ctrl + Aが押された場合
    {
        MessageBox.Show("Ctrl + Aが押されました。");
    }
}

このように、KeyDownイベントを利用することで、ユーザーのキー入力に応じた柔軟な処理を実装できます。

KeyPressイベントの使い方

KeyPressイベントの基本的な設定方法

KeyPressイベントは、ユーザーが文字を入力したときに発生します。

このイベントを使用するには、フォームにイベントハンドラを追加します。

以下のコードは、KeyPressイベントを設定する基本的な方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.KeyPress += new KeyPressEventHandler(MyForm_KeyPress);
    }
    private void MyForm_KeyPress(object sender, KeyPressEventArgs e)
    {
        // 文字が入力されたときの処理をここに記述
    }
}

このコードでは、MyFormクラスのコンストラクタ内でKeyPressイベントに対するハンドラを登録しています。

KeyCharプロパティの利用

KeyPressEventArgsクラスのKeyCharプロパティを使用することで、入力された文字を取得できます。

以下の例では、入力された文字をメッセージボックスで表示します。

private void MyForm_KeyPress(object sender, KeyPressEventArgs e)
{
    MessageBox.Show($"入力された文字: {e.KeyChar}");
}

文字入力の制限方法

特定の文字のみを入力可能にするためには、KeyPressイベント内でKeyPressEventArgsのHandledプロパティを使用します。

以下の例では、数字以外の入力を無効にします。

private void MyForm_KeyPress(object sender, KeyPressEventArgs e)
{
    // 数字以外の入力を無効にする
    if (!char.IsDigit(e.KeyChar))
    {
        e.Handled = true; // 入力を無効にする
    }
}

特殊文字の処理

特殊文字や制御文字を処理する場合も、KeyCharプロパティを利用します。

以下の例では、Enterキーが押されたときに特別な処理を行います。

private void MyForm_KeyPress(object sender, KeyPressEventArgs e)
{
    if (e.KeyChar == (char)Keys.Enter) // Enterキーが押された場合
    {
        MessageBox.Show("Enterキーが押されました。");
        e.Handled = true; // さらに処理を行わない
    }
}

このように、KeyPressイベントを利用することで、ユーザーの文字入力に対して柔軟な制御を行うことができます。

KeyUpイベントの使い方

KeyUpイベントの基本的な設定方法

KeyUpイベントは、ユーザーがキーを離したときに発生します。

このイベントを使用するには、フォームにイベントハンドラを追加します。

以下のコードは、KeyUpイベントを設定する基本的な方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.KeyUp += new KeyEventHandler(MyForm_KeyUp);
    }
    private void MyForm_KeyUp(object sender, KeyEventArgs e)
    {
        // キーが離されたときの処理をここに記述
    }
}

このコードでは、MyFormクラスのコンストラクタ内でKeyUpイベントに対するハンドラを登録しています。

KeyUpイベントでのキーリリース検出

KeyUpイベントを使用することで、特定のキーが離されたことを検出できます。

以下の例では、Spaceキーが離されたときにメッセージボックスを表示します。

private void MyForm_KeyUp(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Space) // Spaceキーが離された場合
    {
        MessageBox.Show("Spaceキーが離されました。");
    }
}

KeyUpイベントの活用例

KeyUpイベントは、ユーザーの操作に応じた動作を実装するのに役立ちます。

例えば、ゲームアプリケーションでは、キャラクターの動きを制御するために使用できます。

以下の例では、Wキーが離されたときにキャラクターを停止させる処理を示します。

private void MyForm_KeyUp(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.W) // Wキーが離された場合
    {
        // キャラクターを停止させる処理
        StopCharacter();
    }
}
private void StopCharacter()
{
    // キャラクターを停止させるロジックをここに記述
    MessageBox.Show("キャラクターが停止しました。");
}

このように、KeyUpイベントを利用することで、ユーザーのキーリリースに応じた柔軟な処理を実装できます。

応用例

ショートカットキーの実装

ショートカットキーは、ユーザーが特定の操作を迅速に行うための便利な機能です。

KeyDownイベントを使用して、ショートカットキーを実装することができます。

以下の例では、Ctrl + Sで保存処理を行うショートカットキーを実装しています。

private void MyForm_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.S && e.Modifiers == Keys.Control) // Ctrl + Sが押された場合
    {
        SaveFile(); // 保存処理を呼び出す
        e.Handled = true; // イベントを処理済みにする
    }
}
private void SaveFile()
{
    // ファイル保存のロジックをここに記述
    MessageBox.Show("ファイルが保存されました。");
}

ゲームでのキー入力処理

ゲームアプリケーションでは、ユーザーのキー入力をリアルタイムで処理することが重要です。

KeyDownおよびKeyUpイベントを使用して、キャラクターの移動やアクションを制御できます。

以下の例では、Wキーで前進し、Sキーで後退する処理を示します。

private bool isMovingForward = false;
private bool isMovingBackward = false;
private void MyForm_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.W) // Wキーが押された場合
    {
        isMovingForward = true;
        MoveCharacterForward();
    }
    else if (e.KeyCode == Keys.S) // Sキーが押された場合
    {
        isMovingBackward = true;
        MoveCharacterBackward();
    }
}
private void MyForm_KeyUp(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.W) // Wキーが離された場合
    {
        isMovingForward = false;
    }
    else if (e.KeyCode == Keys.S) // Sキーが離された場合
    {
        isMovingBackward = false;
    }
}
private void MoveCharacterForward()
{
    // キャラクターを前進させるロジックをここに記述
    MessageBox.Show("キャラクターが前進中です。");
}
private void MoveCharacterBackward()
{
    // キャラクターを後退させるロジックをここに記述
    MessageBox.Show("キャラクターが後退中です。");
}

テキストエディタでの入力制御

テキストエディタアプリケーションでは、ユーザーの入力を制御するためにKeyPressイベントを利用します。

特定の文字を制限したり、特殊な入力を処理したりすることができます。

以下の例では、テキストボックスに数字のみを入力可能にする処理を示します。

private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
{
    // 数字以外の入力を無効にする
    if (!char.IsDigit(e.KeyChar))
    {
        e.Handled = true; // 入力を無効にする
    }
}