キーボード

[C#] キー入力を監視する方法と実装例

C#でキー入力を監視する方法として、主にConsole.ReadKeyメソッドやWindows Forms、WPFのイベントを利用する方法があります。

Console.ReadKeyはコンソールアプリケーションで使用され、キーが押されるたびにその情報を取得できます。

Windows FormsやWPFでは、KeyDownやKeyUpイベントを使用してキー入力を監視します。

これらのイベントは、フォームやコントロールにフォーカスがあるときに発生し、押されたキーの情報を取得できます。

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

これにより、ユーザーのキー入力に応じた処理を実装できます。

目次から探す

コンソールアプリケーションでのキー入力監視
Windows Formsでのキー入力監視
応用例
まとめ

コンソールアプリケーションでのキー入力監視

Console.ReadKeyメソッドの基本

Console.ReadKeyメソッドは、コンソールアプリケーションでユーザーのキー入力を待ち受けるためのメソッドです。

このメソッドは、ユーザーがキーを押すまでプログラムの実行を停止し、押されたキーの情報を取得します。

戻り値はConsoleKeyInfo型で、押されたキーの情報を含んでいます。

主に以下の情報を取得できます。

情報の種類	説明
KeyChar	押されたキーの文字を表す
Key	押されたキーの種類を表す
Modifiers	押された修飾キー(Shift, Alt, Ctrl)

Console.ReadKeyを使った実装例

以下は、Console.ReadKeyメソッドを使用して、ユーザーがキーを押すのを待ち受ける簡単な実装例です。

using System;
public partial class MyForm
{
    public void MonitorKeyInput()
    {
        Console.WriteLine("任意のキーを押してください...");
        // ユーザーのキー入力を待つ
        ConsoleKeyInfo keyInfo = Console.ReadKey();
        // 押されたキーの情報を表示
        Console.WriteLine($"\n押されたキー: {keyInfo.KeyChar}");
        Console.WriteLine($"キーの種類: {keyInfo.Key}");
        Console.WriteLine($"修飾キー: {keyInfo.Modifiers}");
    }
}

このコードを実行すると、コンソールに「任意のキーを押してください…」と表示され、ユーザーがキーを押すと、そのキーの情報が表示されます。

任意のキーを押してください...
a
押されたキー: a
キーの種類: A
修飾キー: None

非同期でのキー入力監視

非同期でキー入力を監視する場合、Taskを使用して別スレッドでキー入力を待つことができます。

これにより、メインスレッドがブロックされずに他の処理を行うことが可能です。

以下はその実装例です。

using System;
using System.Threading.Tasks;
public partial class MyForm
{
    public async Task MonitorKeyInputAsync()
    {
        Console.WriteLine("非同期で任意のキーを押してください...");
        // 非同期でキー入力を待つ
        await Task.Run(() => Console.ReadKey());
        Console.WriteLine("\nキーが押されました。");
    }
}

このコードでは、Task.Runを使用してConsole.ReadKeyを非同期に実行しています。

メインスレッドは他の処理を続けることができます。

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

特定のキー入力を検出するには、Console.ReadKeyの戻り値を条件分岐で評価します。

以下は、特定のキー(例えば、Escキー)を検出する実装例です。

using System;
public partial class MyForm
{
    public void DetectSpecificKey()
    {
        Console.WriteLine("Escキーを押すと終了します。");
        while (true)
        {
            ConsoleKeyInfo keyInfo = Console.ReadKey(true); // trueで入力を表示しない
            // Escキーが押された場合
            if (keyInfo.Key == ConsoleKey.Escape)
            {
                Console.WriteLine("Escキーが押されました。プログラムを終了します。");
                break;
            }
        }
    }
}

このコードでは、ユーザーがEscキーを押すまでループを続け、押された場合にメッセージを表示してプログラムを終了します。

Windows Formsでのキー入力監視

KeyDownイベントの基本

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

このイベントは、キーが押されている間に何度も発生することがあります。

KeyDownイベントを使用することで、特定のキーが押されたときにアクションを実行することができます。

イベントハンドラは、KeyEventArgsを引数に受け取ります。

この引数には、押されたキーの情報が含まれています。

KeyUpイベントの基本

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

このイベントは、キーが離された瞬間に一度だけ発生します。

KeyUpイベントを使用することで、キーが離されたときに特定の処理を実行することができます。

こちらも、KeyEventArgsを引数に受け取ります。

KeyPressイベントの基本

KeyPressイベントは、ユーザーがキーを押したときに発生し、主に文字入力に関連するイベントです。

このイベントは、押されたキーが文字(アルファベットや数字など)の場合に発生します。

KeyPressイベントでは、KeyPressEventArgsを引数に受け取り、押された文字を取得することができます。

特に、文字入力に対する処理を行う際に便利です。

イベントハンドラの設定方法

Windows Formsでのイベントハンドラの設定は、以下のように行います。

フォームのコンストラクタ内で、対象のイベントに対してメソッドを割り当てます。

以下は、KeyDownイベントのハンドラを設定する例です。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        // KeyDownイベントのハンドラを設定
        this.KeyDown += new KeyEventHandler(MyForm_KeyDown);
    }
    private void MyForm_KeyDown(object sender, KeyEventArgs e)
    {
        // キーが押されたときの処理
        Console.WriteLine($"押されたキー: {e.KeyCode}");
    }
}

このコードでは、MyFormのコンストラクタ内でKeyDownイベントにMyForm_KeyDownメソッドを割り当てています。

特定のキーを監視する実装例

特定のキー(例えば、Enterキー)を監視する実装例を以下に示します。

KeyDownイベントを使用して、Enterキーが押されたときに特定の処理を実行します。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.KeyDown += new KeyEventHandler(MyForm_KeyDown);
    }
    private void MyForm_KeyDown(object sender, KeyEventArgs e)
    {
        // Enterキーが押された場合
        if (e.KeyCode == Keys.Enter)
        {
            MessageBox.Show("Enterキーが押されました。");
        }
    }
}

このコードでは、KeyDownイベントでEnterキーが押された場合にメッセージボックスを表示します。

これにより、特定のキー入力に対する反応を簡単に実装できます。

応用例

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

ショートカットキーは、特定のキーの組み合わせを使用して、迅速にアクションを実行するための便利な機能です。

Windows Formsでは、KeyDownイベントを利用してショートカットキーを実装できます。

以下は、Ctrl + Sで保存処理を実行する例です。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.KeyDown += new KeyEventHandler(MyForm_KeyDown);
    }
    private void MyForm_KeyDown(object sender, KeyEventArgs e)
    {
        // Ctrl + Sが押された場合
        if (e.Control && e.KeyCode == Keys.S)
        {
            SaveFile();
            e.SuppressKeyPress = true; // キー入力を抑制
        }
    }
    private void SaveFile()
    {
        MessageBox.Show("ファイルが保存されました。");
    }
}

このコードでは、Ctrl + Sが押されたときにSaveFileメソッドを呼び出し、ファイル保存の処理を行います。

e.SuppressKeyPressをtrueに設定することで、他の処理に影響を与えないようにしています。

ゲームでのキー入力処理

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

以下は、WASDキーを使用してキャラクターを移動させる簡単な実装例です。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private int posX = 0;
    private int posY = 0;
    public MyForm()
    {
        InitializeComponent();
        this.KeyDown += new KeyEventHandler(MyForm_KeyDown);
    }
    private void MyForm_KeyDown(object sender, KeyEventArgs e)
    {
        // WASDキーによる移動処理
        switch (e.KeyCode)
        {
            case Keys.W: // 上
                posY -= 5;
                break;
            case Keys.S: // 下
                posY += 5;
                break;
            case Keys.A: // 左
                posX -= 5;
                break;
            case Keys.D: // 右
                posX += 5;
                break;
        }
        // キャラクターの新しい位置を描画する処理を呼び出す
        UpdateCharacterPosition();
    }
    private void UpdateCharacterPosition()
    {
        // キャラクターの位置を更新する処理
        Console.WriteLine($"キャラクターの位置: ({posX}, {posY})");
    }
}

このコードでは、WASDキーを押すことでキャラクターの位置を更新し、コンソールにその位置を表示します。

ゲームのロジックに応じて、描画処理を追加することができます。

フォームのナビゲーションにキー入力を利用する

フォーム内のナビゲーションをキー入力で行うことも可能です。

例えば、Tabキーを使用してフォーカスを移動させる実装例を以下に示します。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        this.KeyDown += new KeyEventHandler(MyForm_KeyDown);
    }
    private void MyForm_KeyDown(object sender, KeyEventArgs e)
    {
        // Tabキーが押された場合
        if (e.KeyCode == Keys.Tab)
        {
            // 次のコントロールにフォーカスを移動
            SelectNextControl(this.ActiveControl, true, true, true, true);
            e.SuppressKeyPress = true; // キー入力を抑制
        }
    }
}

このコードでは、Tabキーが押されたときに、現在のコントロールから次のコントロールにフォーカスを移動させます。

これにより、ユーザーはキーボードだけでフォーム内をスムーズにナビゲートできます。