フォームで矢印キー入力を正しく受け取るための対策

2025年3月4日

1. 1. はじめに
2. 2. IsInputKey が呼ばれない原因
3. 3. 対策方法
- 3.1. 3.1 ProcessCmdKey のオーバーライド
- 3.2. 3.2 各コントロールの PreviewKeyDown イベントの利用
4. 4. 注意点
5. 5. まとめ

1. はじめに

Windows Forms アプリケーションで、フォーム上に複数のボタンなどのコントロールが配置されている場合、既定ではフォーカスのあるコントロールがキーボード入力を先に受け取るため、フォームの KeyDown イベントや IsInputKey のオーバーライドが期待通りに動作しないことがあります。本資料では、その原因と対策方法を解説します。

2. IsInputKey が呼ばれない原因

フォーカスの問題:
コントロール（例：ボタン）がフォーカスを持っていると、フォーム側の KeyDown イベントや IsInputKey のオーバーライドが呼び出されません。
既定のキー処理:
矢印キーなどは既定でナビゲーションやフォーカス移動の処理が割り当てられているため、IsInputKey で入力キーとして扱おうとしても、そもそもコントロール側で処理されてしまうことがあります。

3. 対策方法

3.1 ProcessCmdKey のオーバーライド

フォーム全体でキー入力をキャッチする確実な方法として、ProcessCmdKey メソッドをオーバーライドする方法があります。
この方法は、どのコントロールがフォーカスを持っていても、指定したキー入力（矢印キーなど）をフォームで先に処理することができます。

サンプルコード

protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    const int moveSpeed = 10;

    if (keyData == Keys.Up)
    {
        if (Hunter.Top - moveSpeed >= 0)
            Hunter.Top -= moveSpeed;
        return true;
    }
    else if (keyData == Keys.Down)
    {
        if (Hunter.Bottom + moveSpeed <= this.ClientSize.Height)
            Hunter.Top += moveSpeed;
        return true;
    }
    else if (keyData == Keys.Left)
    {
        if (Hunter.Left - moveSpeed >= 0)
            Hunter.Left -= moveSpeed;
        return true;
    }
    else if (keyData == Keys.Right)
    {
        if (Hunter.Right + moveSpeed <= this.ClientSize.Width)
            Hunter.Left += moveSpeed;
        return true;
    }

    return base.ProcessCmdKey(ref msg, keyData);
}

このオーバーライドにより、矢印キーの入力がどのコントロールからでも確実にキャッチされ、フォーム内での処理が可能になります。

3.2 各コントロールの PreviewKeyDown イベントの利用

もし特定のコントロールがキー入力を消費してしまう場合、PreviewKeyDown イベントを利用して、該当のキーを入力キーとしてマークする方法も有効です。

サンプルコード（ボタンの場合）

private void Button_PreviewKeyDown(object sender, PreviewKeyDownEventArgs e)
{
    if (e.KeyCode == Keys.Up || e.KeyCode == Keys.Down ||
        e.KeyCode == Keys.Left || e.KeyCode == Keys.Right)
    {
        e.IsInputKey = true;
    }
}

上記のイベントハンドラを各ボタン（または対象コントロール）の PreviewKeyDown イベントに関連付けることで、ボタンがフォーカスを持っていても矢印キー入力がフォームの KeyDown イベントに渡りやすくなります。

4. 注意点

KeyPreview プロパティ:
フォームの KeyPreview プロパティが true に設定されていることを確認してください。これにより、フォームが全てのキーボード入力を最初に受け取ります。
フォーカスの設定:
フォームロード時に this.Focus(); を呼び出すなど、フォームにフォーカスを当てる工夫も重要です。特定のコントロールにフォーカスが移ってしまうと、キーイベントが発生しない場合があります。
実装の選択:
全体でキー入力を統一的に処理したい場合は、ProcessCmdKey のオーバーライドがシンプルで効果的です。特定のコントロールでの入力を調整する場合は、PreviewKeyDown イベントの利用を検討してください。