C#のKeyDownイベント完全ガイド｜発生しない原因からキー判定・KeyPressとの違いまで解説

はじめに

C#でWindowsアプリを開発していると、「Enterキーを押したら検索する」「Escキーで画面を閉じる」「Ctrl＋Sで保存する」「矢印キーでキャラクターやカーソルを動かす」といったキー操作を実装したくなる場面があります。

そのときによく使われるのが、KeyDownイベントです。

KeyDownは、キーボードのキーが押された瞬間に発生するイベントで、WinFormsやWPFなどのGUIアプリケーションで頻繁に利用されます。ただし、実際に使ってみると次のような問題にぶつかることがあります。

「KeyDownイベントが発生しない」

「Enterキーは取得できるのに矢印キーが反応しない」

「TextBoxにフォーカスがあるとFormのKeyDownが動かない」

「KeyPressとの違いがよく分からない」

「Ctrl＋Sのようなショートカットキーをどう判定すればいいのか分からない」

この記事では、C#のKeyDownイベントについて、基本的な使い方からキー判定、発生しない原因、KeyPressやKeyUpとの違い、実用的なサンプルまで詳しく解説します。

1. C#のKeyDownイベントとは

1-1. KeyDownイベントの基本概要

KeyDownイベントとは、キーボードのキーが押されたときに発生するイベントです。

C#のWinFormsでは、フォームやコントロールに対してKeyDownイベントを設定できます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    MessageBox.Show(e.KeyCode.ToString());
}

この例では、フォーム上でキーが押されると、押されたキーの名前がメッセージボックスに表示されます。

KeyDownは「キーが押された瞬間」を検知するイベントなので、文字入力だけでなく、Enterキー、Escキー、矢印キー、ファンクションキー、Ctrlキー、Shiftキー、Altキーなどの特殊キーも扱えます。

そのため、アプリケーションの操作性を高めるショートカットキーや、ゲームのキー操作、入力補助などに向いています。

1-2. キーが押されたときに発生するイベントの仕組み

C#のWinFormsでは、キーボード操作に関連する主なイベントとして、次の3つがあります。

KeyDown → KeyPress → KeyUp

基本的には、キーを押すとKeyDownが発生し、文字として入力可能なキーであればKeyPressが発生し、キーを離すとKeyUpが発生します。

たとえば、キーボードの「A」キーを押して離した場合は、次のような流れになります。

Aキーを押す
↓
KeyDown発生
↓
KeyPress発生
↓
Aキーを離す
↓
KeyUp発生

一方で、ShiftキーやCtrlキー、矢印キーなどは文字入力ではないため、KeyPressが発生しない場合があります。しかしKeyDownでは、こうした特殊キーも判定できます。

つまり、KeyDownは「どのキーが押されたか」を判定するためのイベントであり、KeyPressは「どの文字が入力されたか」を扱うイベントと考えると分かりやすいです。

1-3. KeyDownが使われる代表的な場面

KeyDownイベントは、次のような場面でよく使われます。

Enterキーで検索処理を実行する
Escキーで画面を閉じる
Ctrl＋Sで保存する
Ctrl＋C、Ctrl＋Vなどのショートカットを判定する
矢印キーで項目やオブジェクトを移動する
F1キーでヘルプを表示する
数字キーでメニューを選択する
ゲームや業務アプリでキーボード操作を実装する

たとえば、Enterキーでボタンのクリック処理を呼び出す場合は、次のように書けます。

C#
private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        button1.PerformClick();
    }
}

このように、KeyDownを使うと、マウス操作だけでなくキーボード操作にも対応したアプリケーションを作ることができます。

1-4. WinFormsとWPFでのKeyDownイベントの違い

C#のKeyDownイベントは、WinFormsとWPFの両方で使えます。ただし、イベントの仕組みや引数の型、キーの判定方法が少し異なります。

WinFormsでは、主にSystem.Windows.Forms.KeyEventArgsを使います。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }
}

WPFでは、主にSystem.Windows.Input.KeyEventArgsを使います。

C#
private void Window_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Key == Key.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }
}

WinFormsではKeys.Enter、WPFではKey.Enterのように、キーを表す列挙型が異なります。

また、WPFには通常のKeyDownだけでなく、先にイベントを受け取れるPreviewKeyDownがあります。WPFのイベントは「ルーティングイベント」という仕組みで、親要素や子要素を伝わって処理される点もWinFormsとは異なります。

この記事では主にWinFormsを中心に解説し、必要に応じてWPFの違いも補足します。

2. C#でKeyDownイベントを使う基本手順

2-1. WinFormsでKeyDownイベントを設定する方法

WinFormsでKeyDownイベントを使うには、対象のフォームまたはコントロールにイベントハンドラを設定します。

最も基本的な流れは次のとおりです。

1. フォームまたはコントロールを用意する
2. KeyDownイベントを登録する
3. イベントハンドラ内で押されたキーを判定する
4. 必要な処理を実行する

フォーム全体でキー入力を受け取りたい場合は、フォームのKeyDownイベントを使います。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }
}

ただし、フォーム上にTextBoxやButtonなどのコントロールがある場合、キー入力はフォーカスを持っているコントロールに送られるため、フォームのKeyDownが発生しないことがあります。

その場合は、後述するKeyPreviewプロパティを使います。

2-2. Visual Studioのデザイナーからイベントを追加する方法

Visual Studioのデザイナーを使うと、コードを手で書かなくてもKeyDownイベントを追加できます。

手順は次のとおりです。

1. Windowsフォームデザイナーを開く
2. 対象のフォームまたはコントロールを選択する
3. プロパティウィンドウを表示する
4. 稲妻アイコンをクリックしてイベント一覧を表示する
5. KeyDown欄をダブルクリックする
6. 自動生成されたイベントハンドラに処理を書く

たとえば、フォームのKeyDownイベントを追加すると、次のようなメソッドが生成されます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{

}

この中にキー判定処理を書きます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Escape)
    {
        this.Close();
    }
}

デザイナーからイベントを設定すると、InitializeComponent内でイベント登録が自動的に行われます。

C#
this.KeyDown += new System.Windows.Forms.KeyEventHandler(this.Form1_KeyDown);

通常は自分でこのコードを編集する必要はありません。

2-3. コードでKeyDownイベントハンドラを登録する方法

デザイナーを使わず、コードでKeyDownイベントを登録することもできます。

C#
public Form1()
{
    InitializeComponent();

    this.KeyDown += Form1_KeyDown;
}

イベントハンドラは次のように定義します。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }
}

TextBoxに対して設定する場合は、次のように書きます。

C#
public Form1()
{
    InitializeComponent();

    textBox1.KeyDown += textBox1_KeyDown;
}

private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("TextBoxでEnterキーが押されました");
    }
}

コードで登録する方法は、動的に作成したコントロールにイベントを設定したい場合にも便利です。

C#
TextBox textBox = new TextBox();
textBox.Location = new Point(20, 20);
textBox.KeyDown += TextBox_KeyDown;
this.Controls.Add(textBox);

2-4. KeyEventArgsで取得できる主な情報

WinFormsのKeyDownイベントでは、イベント引数としてKeyEventArgsが渡されます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
}

このeから、押されたキーに関する情報を取得できます。

代表的なプロパティは次のとおりです。

KeyCode：押されたキー本体を表す
KeyData：キー本体と修飾キーを含む情報を表す
KeyValue：キーコードの数値を表す
Modifiers：Ctrl、Shift、Altなどの修飾キーを表す
Alt：Altキーが押されているかを表す
Control：Ctrlキーが押されているかを表す
Shift：Shiftキーが押されているかを表す
Handled：イベントを処理済みにするかどうかを表す
SuppressKeyPress：後続のキーイベントや入力を抑制するかどうかを表す

たとえば、押されたキーの情報を画面に表示するには、次のように書きます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    label1.Text =
        $"KeyCode: {e.KeyCode}\n" +
        $"KeyData: {e.KeyData}\n" +
        $"KeyValue: {e.KeyValue}\n" +
        $"Modifiers: {e.Modifiers}";
}

キー判定では、基本的にe.KeyCodeを使うことが多いです。CtrlやShiftなどとの組み合わせを判定する場合は、e.Controlやe.Modifiersを使います。

2-5. KeyCode・KeyData・KeyValueの違い

KeyEventArgsには、似た名前のプロパティとしてKeyCode、KeyData、KeyValueがあります。

それぞれの違いを理解しておくと、キー判定のコードが書きやすくなります。

KeyCodeは、押されたキー本体を表します。

C#
if (e.KeyCode == Keys.S)
{
    MessageBox.Show("Sキーが押されました");
}

KeyDataは、キー本体に加えてCtrl、Shift、Altなどの修飾キーも含んだ情報を表します。

C#
if (e.KeyData == (Keys.Control | Keys.S))
{
    MessageBox.Show("Ctrl + S が押されました");
}

KeyValueは、キーコードを数値で表します。

C#
label1.Text = e.KeyValue.ToString();

通常の判定ではKeyCodeを使い、ショートカットキーのように修飾キー込みで判定したい場合はKeyDataやModifiersを使うとよいでしょう。

ただし、可読性を重視するなら、次のように書く方法が分かりやすいです。

C#
if (e.Control && e.KeyCode == Keys.S)
{
    Save();
}

e.Controlやe.Shiftを使うと、「Ctrlキーが押されていて、かつSキーが押された」という意図が読み取りやすくなります。

3. KeyDownイベントで押されたキーを判定する方法

3-1. 特定のキーを判定する基本コード

KeyDownイベントで押されたキーを判定する基本形は、e.KeyCodeを使ったif文です。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }
}

複数のキーを判定する場合は、if文を並べてもよいですが、キーの種類が多い場合はswitch文を使うと見やすくなります。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    switch (e.KeyCode)
    {
        case Keys.Enter:
            MessageBox.Show("Enterキー");
            break;

        case Keys.Escape:
            MessageBox.Show("Escキー");
            break;

        case Keys.Space:
            MessageBox.Show("Spaceキー");
            break;
    }
}

KeyDownでは、文字キーだけでなく、特殊キーやファンクションキーも判定できます。

C#
if (e.KeyCode == Keys.F1)
{
    MessageBox.Show("ヘルプを表示します");
}

3-2. Enterキー・Escキー・Spaceキーを判定する方法

よく使うキーとして、Enterキー、Escキー、Spaceキーがあります。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }

    if (e.KeyCode == Keys.Escape)
    {
        MessageBox.Show("Escキーが押されました");
    }

    if (e.KeyCode == Keys.Space)
    {
        MessageBox.Show("Spaceキーが押されました");
    }
}

Enterキーでボタン処理を実行したい場合は、PerformClickを使えます。

C#
private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        buttonSearch.PerformClick();
        e.SuppressKeyPress = true;
    }
}

e.SuppressKeyPress = true;を設定すると、Enterキーによるビープ音や改行入力を抑制できます。

Escキーでフォームを閉じる場合は、次のように書けます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Escape)
    {
        this.Close();
    }
}

Spaceキーは、ボタンやチェックボックスにフォーカスがあるとコントロール側で処理されることがあります。その場合は、フォーム側で受け取るためにKeyPreviewやProcessCmdKeyの利用を検討します。

3-3. 矢印キーを判定する方法

矢印キーは、Keys.Up、Keys.Down、Keys.Left、Keys.Rightで判定します。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    switch (e.KeyCode)
    {
        case Keys.Up:
            label1.Top -= 5;
            break;

        case Keys.Down:
            label1.Top += 5;
            break;

        case Keys.Left:
            label1.Left -= 5;
            break;

        case Keys.Right:
            label1.Left += 5;
            break;
    }
}

この例では、矢印キーを押すとlabel1の位置が上下左右に移動します。

ただし、矢印キーはフォーカス移動やコントロール内のカーソル移動に使われることが多いため、通常のKeyDownでは取得できない場合があります。

特に、Button、TextBox、DataGridViewなどのコントロールにフォーカスがある場合、矢印キーはコントロール側で処理されることがあります。

その場合は、次の方法を検討します。

KeyPreviewをtrueにする
PreviewKeyDownイベントを使う
IsInputKeyをオーバーライドする
ProcessCmdKeyを使う

これらの方法は、後の「特殊キーや反応しにくいキーを処理する方法」で詳しく解説します。

3-4. 数字キー・英字キーを判定する方法

数字キーを判定する場合、キーボード上部の数字キーとテンキーは別のキーとして扱われます。

キーボード上部の数字キーは、Keys.D0からKeys.D9です。

C#
if (e.KeyCode == Keys.D1)
{
    MessageBox.Show("数字の1キーが押されました");
}

テンキーの数字キーは、Keys.NumPad0からKeys.NumPad9です。

C#
if (e.KeyCode == Keys.NumPad1)
{
    MessageBox.Show("テンキーの1キーが押されました");
}

上部の1キーとテンキーの1キーの両方を同じ処理にしたい場合は、次のように書きます。

C#
if (e.KeyCode == Keys.D1 || e.KeyCode == Keys.NumPad1)
{
    MessageBox.Show("1キーが押されました");
}

英字キーは、Keys.AからKeys.Zで判定します。

C#
if (e.KeyCode == Keys.A)
{
    MessageBox.Show("Aキーが押されました");
}

KeyDownでは、Shiftキーを押しながらAキーを押しても、基本的にKeyCodeはKeys.Aです。大文字・小文字の文字そのものを取得したい場合は、KeyPressやTextBoxのTextChangedを検討します。

3-5. Ctrl・Shift・Altなど修飾キーを判定する方法

Ctrl、Shift、Altなどの修飾キーは、e.Control、e.Shift、e.Altで判定できます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Control)
    {
        MessageBox.Show("Ctrlキーが押されています");
    }

    if (e.Shift)
    {
        MessageBox.Show("Shiftキーが押されています");
    }

    if (e.Alt)
    {
        MessageBox.Show("Altキーが押されています");
    }
}

特定のキーと組み合わせて判定する場合は、次のように書きます。

C#
if (e.Control && e.KeyCode == Keys.S)
{
    MessageBox.Show("Ctrl + S が押されました");
}

Shift＋Enterを判定する場合は、次のように書けます。

C#
if (e.Shift && e.KeyCode == Keys.Enter)
{
    MessageBox.Show("Shift + Enter が押されました");
}

Ctrl＋Shift＋Sのように複数の修飾キーを判定することもできます。

C#
if (e.Control && e.Shift && e.KeyCode == Keys.S)
{
    MessageBox.Show("Ctrl + Shift + S が押されました");
}

3-6. ショートカットキーを実装する方法

ショートカットキーを実装する場合は、KeyDownイベントで修飾キーと通常キーの組み合わせを判定します。

たとえば、Ctrl＋Sで保存処理を実行するコードは次のとおりです。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Control && e.KeyCode == Keys.S)
    {
        SaveFile();
        e.SuppressKeyPress = true;
    }
}

private void SaveFile()
{
    MessageBox.Show("保存しました");
}

Ctrl＋Nで新規作成、Ctrl＋Oで開く、Ctrl＋Sで保存する例です。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Control && e.KeyCode == Keys.N)
    {
        NewFile();
        e.SuppressKeyPress = true;
    }
    else if (e.Control && e.KeyCode == Keys.O)
    {
        OpenFile();
        e.SuppressKeyPress = true;
    }
    else if (e.Control && e.KeyCode == Keys.S)
    {
        SaveFile();
        e.SuppressKeyPress = true;
    }
}

ショートカットキーでは、処理後にe.SuppressKeyPress = true;を設定することがよくあります。これにより、TextBoxなどに不要な文字が入力されたり、ビープ音が鳴ったりするのを防ぎやすくなります。

ただし、本格的なメニュー付きアプリケーションでは、MenuStripやToolStripMenuItemのShortcutKeysプロパティを使う方法もあります。

C#
saveToolStripMenuItem.ShortcutKeys = Keys.Control | Keys.S;

画面全体でショートカットキーを扱う場合は、KeyDownだけでなくProcessCmdKeyも選択肢になります。

3-7. 複数キーの組み合わせを判定する方法

Ctrl＋Sのような「修飾キー＋通常キー」であれば、e.Controlやe.Shiftを使えば簡単に判定できます。

C#
if (e.Control && e.KeyCode == Keys.S)
{
    SaveFile();
}

一方で、「Aキーを押しながらBキーを押す」のように、通常キー同士の同時押しを判定したい場合は、現在押されているキーを管理する必要があります。

たとえば、HashSet<Keys>を使って押下中のキーを記録できます。

C#
private HashSet<Keys> pressedKeys = new HashSet<Keys>();

private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    pressedKeys.Add(e.KeyCode);

    if (pressedKeys.Contains(Keys.A) && pressedKeys.Contains(Keys.B))
    {
        label1.Text = "A + B が押されています";
    }
}

private void Form1_KeyUp(object sender, KeyEventArgs e)
{
    pressedKeys.Remove(e.KeyCode);
}

ゲームや操作画面では、このようにKeyDownでキーを追加し、KeyUpでキーを削除する方法がよく使われます。

ただし、キーボードの仕様や環境によっては、同時押しできるキー数に制限があります。確実に複雑な同時押しを扱いたい場合は、入力設計そのものを見直すことも大切です。

4. KeyDownイベントが発生しない原因と対処法

4-1. フォームにフォーカスが当たっていない

KeyDownイベントが発生しない原因として、まず確認したいのがフォーカスです。

キーボード入力は、基本的に現在フォーカスを持っているフォームやコントロールに送られます。そのため、対象のフォームやコントロールにフォーカスがない場合、KeyDownは発生しません。

たとえば、フォームにKeyDownイベントを書いていても、実際にはTextBoxにフォーカスがある場合、キー入力はTextBoxに送られます。

フォームにフォーカスを当てたい場合は、次のようにFocusを呼び出すことがあります。

C#
this.Focus();

ただし、フォーム上にフォーカス可能なコントロールがある場合、フォーム自体にフォーカスを当てるのは思ったように動かないことがあります。

そのため、フォーム全体でキー入力を受け取りたい場合は、KeyPreviewを使うのが一般的です。

C#
this.KeyPreview = true;

4-2. TextBoxやButtonなど別コントロールにフォーカスがある

フォーム上にTextBoxやButtonなどがある場合、多くの場合はそれらのコントロールにフォーカスがあります。

この状態でキーを押すと、フォームではなく、フォーカスを持っているコントロールのKeyDownイベントが発生します。

たとえば、TextBoxにフォーカスがある場合は、次のイベントが発生します。

C#
private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    label1.Text = "TextBoxでキーが押されました";
}

フォーム側で受け取りたい場合は、フォームのKeyPreviewをtrueにします。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
    this.KeyDown += Form1_KeyDown;
}

これにより、フォーカスがTextBoxにあっても、フォームのKeyDownイベントが先に発生します。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.F1)
    {
        MessageBox.Show("ヘルプを表示します");
    }
}

ただし、すべてのキーを必ずフォームで取得できるわけではありません。Tabキーや矢印キーなど、一部のキーはコントロール側で特殊な処理に使われるため、別の対応が必要になることがあります。

4-3. FormのKeyPreviewがfalseになっている

フォーム全体でキー入力を受け取りたいのにKeyDownが発生しない場合、KeyPreviewがfalseになっている可能性があります。

KeyPreviewは、フォームがコントロールより先にキーイベントを受け取るかどうかを決めるプロパティです。

初期値は通常falseです。

C#
this.KeyPreview = true;

デザイナーから設定する場合は、フォームを選択してプロパティウィンドウのKeyPreviewをTrueにします。

コードで設定する場合は、コンストラクタでInitializeComponentの後に書くのが一般的です。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
}

KeyPreviewをtrueにすると、フォーカスが子コントロールにあっても、フォームのキーイベントが先に呼ばれます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Escape)
    {
        this.Close();
    }
}

フォーム全体のEscキー処理やショートカットキー処理には、KeyPreviewが非常に便利です。

4-4. 矢印キー・Tabキー・Enterキーが反応しない

KeyDownイベント自体は設定できているのに、矢印キー、Tabキー、Enterキーなどが反応しないことがあります。

これは、これらのキーがコントロールの操作やフォーカス移動に使われるためです。

たとえば、Tabキーは通常、次のコントロールへフォーカスを移動するために使われます。矢印キーは、Button間の移動やTextBox内のカーソル移動に使われることがあります。Enterキーは、フォームの既定ボタンやTextBoxの入力確定として扱われることがあります。

このようなキーは、通常の入力キーではなく「操作キー」として先に処理される場合があります。

対処法としては、次のような方法があります。

PreviewKeyDownイベントで入力キーとして扱う
IsInputKeyをオーバーライドする
ProcessCmdKeyをオーバーライドする
AcceptButtonやCancelButtonを利用する

たとえば、Buttonで矢印キーをKeyDownとして扱いたい場合は、PreviewKeyDownを使って次のように書けます。

C#
private void button1_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;
    }
}

4-5. コントロール側でキー入力が処理されている

TextBox、Button、DataGridView、ComboBoxなどのコントロールは、キー入力に対して独自の処理を持っています。

たとえば、TextBoxでは左右矢印キーがカーソル移動に使われます。DataGridViewでは矢印キーがセル移動に使われます。ButtonではSpaceキーやEnterキーがクリック操作として扱われることがあります。

このような場合、フォーム側のKeyDownに処理を書いても、期待どおりに発生しないことがあります。

対処法は、目的によって変わります。

特定のコントロールだけでキー入力を処理したい場合は、そのコントロールのKeyDownイベントに処理を書きます。

C#
private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Search();
        e.SuppressKeyPress = true;
    }
}

フォーム全体でショートカットキーを処理したい場合は、KeyPreviewやProcessCmdKeyを使います。

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    if (keyData == (Keys.Control | Keys.S))
    {
        SaveFile();
        return true;
    }

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

ProcessCmdKeyは、ショートカットキーやコマンドキーを処理したい場合に有効です。

4-6. イベントハンドラが正しく登録されていない

KeyDownが発生しない場合、イベントハンドラが正しく登録されていない可能性もあります。

たとえば、次のようなメソッドを書いただけでは、イベントは発生しません。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    MessageBox.Show("キーが押されました");
}

このメソッドをイベントに登録する必要があります。

デザイナーで設定するか、コードで次のように登録します。

C#
this.KeyDown += Form1_KeyDown;

コンストラクタに書く場合は、通常InitializeComponentの後に書きます。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
    this.KeyDown += Form1_KeyDown;
}

また、デザイナーでイベント名を変更したり、メソッドを削除したりすると、イベント登録が壊れることがあります。

その場合は、プロパティウィンドウのイベント一覧でKeyDownに正しいメソッドが設定されているか確認しましょう。

4-7. WPFでKeyDownが発生しない場合の確認ポイント

WPFでKeyDownが発生しない場合も、まずフォーカスを確認します。

WPFでは、キーボードイベントは基本的にフォーカスを持つ要素から発生します。

XML
<Window x:Class="SampleApp.MainWindow"
        KeyDown="Window_KeyDown"
        Focusable="True">
</Window>

コードビハインドでは次のように書きます。

C#
private void Window_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Key == Key.Enter)
    {
        MessageBox.Show("Enterキーが押されました");
    }
}

WPFでは、特定のコントロールがキーイベントを処理済みにしてしまうことがあります。その場合、親要素のKeyDownに届かないことがあります。

先にイベントを受け取りたい場合は、PreviewKeyDownを使います。

XML
<Window x:Class="SampleApp.MainWindow"
        PreviewKeyDown="Window_PreviewKeyDown">
</Window>

C#
private void Window_PreviewKeyDown(object sender, KeyEventArgs e)
{
    if (e.Key == Key.Escape)
    {
        this.Close();
    }
}

また、すでに処理済みになったイベントも受け取りたい場合は、AddHandlerでhandledEventsTooを指定する方法があります。

C#
public MainWindow()
{
    InitializeComponent();

    this.AddHandler(
        Keyboard.KeyDownEvent,
        new KeyEventHandler(Window_KeyDown),
        true);
}

WPFでは、e.KeyがKey.Systemになる場合があります。Altキーとの組み合わせなどでは、e.SystemKeyも確認します。

C#
if (e.SystemKey == Key.F4)
{
    // Alt + F4 など
}

4-8. KeyDownが発生しないときのチェックリスト

KeyDownが発生しないときは、次の順番で確認すると原因を見つけやすいです。

イベントハンドラが登録されているか
対象のフォームまたはコントロールにフォーカスがあるか
フォーム全体で受け取りたい場合はKeyPreviewがtrueか
TextBoxやButtonなど子コントロールにフォーカスが奪われていないか
矢印キーやTabキーなど特殊キーを扱おうとしていないか
コントロール側でキーが処理されていないか
e.HandledやSuppressKeyPressで意図せず処理を止めていないか
WPFの場合はPreviewKeyDownやAddHandlerが必要ではないか

特にWinFormsでフォーム全体のキー入力を受け取りたい場合は、まず次の3点を確認しましょう。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
    this.KeyDown += Form1_KeyDown;
}

そして、イベントハンドラに一時的な確認コードを入れます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    MessageBox.Show(e.KeyCode.ToString());
}

これで反応するか確認すると、イベント登録の問題なのか、特定キーだけの問題なのかを切り分けやすくなります。

5. Form全体でキー入力を受け取る方法

5-1. KeyPreviewプロパティの役割

WinFormsでフォーム全体のキー入力を受け取りたい場合、重要なのがKeyPreviewプロパティです。

通常、キー入力はフォーカスを持っているコントロールに送られます。たとえば、TextBoxにフォーカスがあると、フォームではなくTextBoxのKeyDownが発生します。

しかし、フォームのKeyPreviewをtrueにすると、フォームが子コントロールより先にキーイベントを受け取れるようになります。

C#
this.KeyPreview = true;

これにより、TextBoxに入力中でも、フォーム側でEscキーやCtrl＋Sなどのショートカットキーを処理しやすくなります。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Escape)
    {
        this.Close();
    }
}

KeyPreviewは、フォーム全体の共通ショートカットを実装するときに非常によく使われます。

5-2. KeyPreviewをtrueに設定する方法

KeyPreviewを設定する方法は、デザイナーから設定する方法と、コードで設定する方法があります。

デザイナーで設定する場合は、フォームを選択し、プロパティウィンドウからKeyPreviewをTrueにします。

コードで設定する場合は、コンストラクタに書きます。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
}

そのうえで、フォームのKeyDownイベントを設定します。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
    this.KeyDown += Form1_KeyDown;
}

private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.F1)
    {
        MessageBox.Show("ヘルプを表示します");
    }
}

KeyPreviewを設定してもイベントハンドラが登録されていなければ処理は実行されません。KeyPreviewとKeyDownイベント登録の両方を確認しましょう。

5-3. フォーム全体でショートカットキーを処理する実装例

フォーム全体でショートカットキーを処理する例を見てみましょう。

次のコードでは、Ctrl＋Sで保存、Ctrl＋Nで新規作成、Escでフォームを閉じます。

C#
public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();

        this.KeyPreview = true;
        this.KeyDown += Form1_KeyDown;
    }

    private void Form1_KeyDown(object sender, KeyEventArgs e)
    {
        if (e.Control && e.KeyCode == Keys.S)
        {
            SaveFile();
            e.SuppressKeyPress = true;
        }
        else if (e.Control && e.KeyCode == Keys.N)
        {
            NewFile();
            e.SuppressKeyPress = true;
        }
        else if (e.KeyCode == Keys.Escape)
        {
            this.Close();
        }
    }

    private void SaveFile()
    {
        MessageBox.Show("保存しました");
    }

    private void NewFile()
    {
        MessageBox.Show("新規作成しました");
    }
}

ポイントは、this.KeyPreview = true;を設定していることです。

これにより、フォーム上のTextBoxやButtonにフォーカスがあっても、フォーム側でショートカットキーを処理しやすくなります。

ただし、すべてのキーが必ずフォームに届くわけではありません。特にTabキーや矢印キーなどは、別の方法が必要になる場合があります。

5-4. TextBox入力中でもキーイベントを拾う方法

TextBoxにフォーカスがある状態でもフォーム側でキーイベントを拾いたい場合は、KeyPreviewを使います。

C#
public Form1()
{
    InitializeComponent();

    this.KeyPreview = true;
    this.KeyDown += Form1_KeyDown;
}

たとえば、TextBox入力中でもEscキーでフォームを閉じたい場合は、次のように書きます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Escape)
    {
        this.Close();
    }
}

TextBox入力中でもCtrl＋Sで保存したい場合は、次のように書きます。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Control && e.KeyCode == Keys.S)
    {
        SaveFile();
        e.SuppressKeyPress = true;
    }
}

一方で、EnterキーをTextBox固有の処理として扱いたい場合は、TextBoxのKeyDownイベントに書くほうが自然です。

C#
private void textBoxSearch_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Search();
        e.SuppressKeyPress = true;
    }
}

フォーム全体の共通処理なのか、特定の入力欄だけの処理なのかを分けて考えることが大切です。

5-5. KeyPreviewで解決できないケース

KeyPreviewは便利ですが、万能ではありません。

次のようなケースでは、KeyPreviewをtrueにしても期待どおりにKeyDownが発生しないことがあります。

Tabキーがフォーカス移動として処理される
矢印キーがコントロール内の移動に使われる
Enterキーが既定ボタンのクリックとして処理される
DataGridViewなどの複雑なコントロールがキーを内部処理する
コントロールがキーイベントを処理済みにしている

このような場合は、PreviewKeyDown、IsInputKey、ProcessCmdKeyなどを使う必要があります。

たとえば、ショートカットキーを確実に処理したい場合は、ProcessCmdKeyが有効です。

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    if (keyData == (Keys.Control | Keys.S))
    {
        SaveFile();
        return true;
    }

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

return true;を返すと、そのキー入力を処理済みとして扱います。KeyDownでうまく拾えないショートカットキーは、ProcessCmdKeyで処理することを検討しましょう。

6. 特殊キーや反応しにくいキーを処理する方法

6-1. 矢印キーがKeyDownで反応しない理由

矢印キーは、KeyDownで取得できる場合もありますが、コントロールの種類やフォーカス状態によっては反応しないことがあります。

理由は、矢印キーが「入力文字」ではなく、コントロールの操作に使われるキーだからです。

たとえば、TextBoxでは左右矢印キーがカーソル移動に使われます。DataGridViewではセル移動に使われます。ButtonやRadioButtonでは、フォーカス移動に使われる場合があります。

そのため、矢印キーは通常のKeyDownイベントより前に、コントロール側で処理されることがあります。

フォーム上で矢印キーを使ってオブジェクトを移動したい場合、単純に次のコードを書いても反応しないことがあります。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Left)
    {
        label1.Left -= 5;
    }
}

この場合は、KeyPreviewを設定したり、対象コントロールでPreviewKeyDownを使ったり、フォームのProcessCmdKeyで処理したりします。

6-2. TabキーがKeyDownで取得しにくい理由

Tabキーは、通常「次のコントロールへフォーカスを移動するキー」として扱われます。

そのため、KeyDownでTabキーを取得しようとしても、イベントが発生しないことがあります。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Tab)
    {
        MessageBox.Show("Tabキー");
    }
}

このコードが動かない場合、Tabキーがフォーカス移動として先に処理されている可能性があります。

Tabキーを独自の操作に使いたい場合は、ProcessCmdKeyを使う方法があります。

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    if (keyData == Keys.Tab)
    {
        MessageBox.Show("Tabキーを処理しました");
        return true;
    }

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

ただし、Tabキーはユーザーが画面内を移動するための重要なキーです。むやみに独自処理に使うと、操作性やアクセシビリティが悪くなる可能性があります。

本当にTabキーを独自処理に使う必要があるか、慎重に判断しましょう。

6-3. PreviewKeyDownイベントを使う方法

WinFormsには、KeyDownの前段階でキーを確認できるPreviewKeyDownイベントがあります。

PreviewKeyDownは、矢印キーやTabキーなど、通常は入力キーとして扱われにくいキーを入力キーとして扱いたい場合に使えます。

たとえば、Buttonで矢印キーを取得したい場合は、次のように書きます。

C#
private void button1_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;
    }
}

そのうえで、KeyDownイベントに処理を書きます。

C#
private void button1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Left)
    {
        MessageBox.Show("左キーが押されました");
    }
}

PreviewKeyDownでe.IsInputKey = true;を設定することで、そのキーを通常の入力キーとして扱わせることができます。

矢印キーがKeyDownで反応しない場合に試したい方法のひとつです。

6-4. IsInputKeyを使って特殊キーを入力キーとして扱う方法

より本格的に特殊キーを入力キーとして扱いたい場合は、コントロールを継承してIsInputKeyをオーバーライドします。

たとえば、矢印キーを入力キーとして扱うカスタムButtonを作る例です。

C#
public class ArrowButton : Button
{
    protected override bool IsInputKey(Keys keyData)
    {
        switch (keyData & Keys.KeyCode)
        {
            case Keys.Up:
            case Keys.Down:
            case Keys.Left:
            case Keys.Right:
                return true;
        }

        return base.IsInputKey(keyData);
    }
}

このようにすると、矢印キーが入力キーとして扱われ、KeyDownで取得しやすくなります。

C#
private void arrowButton1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Up)
    {
        MessageBox.Show("上キー");
    }
}

IsInputKeyのオーバーライドは、特定のコントロールで特殊キーを継続的に扱いたい場合に向いています。

一時的な対応ならPreviewKeyDown、ショートカットキー全体を処理するならProcessCmdKeyを使うなど、目的に応じて使い分けましょう。

6-5. ProcessCmdKeyでショートカットキーを処理する方法

ProcessCmdKeyは、コマンドキーやショートカットキーを処理するためのメソッドです。

KeyDownで取得しにくいキーや、フォーム全体のショートカットキーを処理したい場合に便利です。

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    if (keyData == (Keys.Control | Keys.S))
    {
        SaveFile();
        return true;
    }

    if (keyData == Keys.Escape)
    {
        this.Close();
        return true;
    }

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

return true;を返すと、そのキーは処理済みになります。

return base.ProcessCmdKey(ref msg, keyData);を返すと、通常の処理に戻します。

矢印キーを処理する例です。

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    switch (keyData)
    {
        case Keys.Left:
            label1.Left -= 5;
            return true;

        case Keys.Right:
            label1.Left += 5;
            return true;

        case Keys.Up:
            label1.Top -= 5;
            return true;

        case Keys.Down:
            label1.Top += 5;
            return true;
    }

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

ProcessCmdKeyは強力ですが、使いすぎると通常のコントロール操作を妨げることがあります。ショートカットキーや特殊キーを明確に処理したい場面で使うのがおすすめです。

6-6. KeyDown・PreviewKeyDown・ProcessCmdKeyの使い分け

KeyDown、PreviewKeyDown、ProcessCmdKeyは、どれもキー入力に関係しますが、目的が異なります。

通常のキー入力を扱いたい場合は、まずKeyDownを使います。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Search();
    }
}

矢印キーなどを入力キーとして扱いたい場合は、PreviewKeyDownを使います。

C#
private void button1_PreviewKeyDown(object sender, PreviewKeyDownEventArgs e)
{
    if (e.KeyCode == Keys.Left || e.KeyCode == Keys.Right)
    {
        e.IsInputKey = true;
    }
}

ショートカットキーやコマンドキーをフォーム全体で処理したい場合は、ProcessCmdKeyを使います。

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    if (keyData == (Keys.Control | Keys.S))
    {
        SaveFile();
        return true;
    }

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

使い分けの目安は次のとおりです。

通常のキー判定：KeyDown
矢印キーなどを入力キー扱いにしたい：PreviewKeyDown
特定コントロールで特殊キーを常に扱いたい：IsInputKey
ショートカットキーを強めに処理したい：ProcessCmdKey
WPFで先にキーを受け取りたい：PreviewKeyDown

まずはKeyDownで実装し、反応しないキーがある場合にKeyPreview、PreviewKeyDown、ProcessCmdKeyを検討するとよいでしょう。

7. KeyDown・KeyPress・KeyUpの違い

7-1. KeyDown・KeyPress・KeyUpの発生順序

キーボード操作に関する代表的なイベントは、KeyDown、KeyPress、KeyUpです。

基本的な発生順序は次のとおりです。

KeyDown
↓
KeyPress
↓
KeyUp

たとえば、Aキーを押して離すと、次の順番でイベントが発生します。

Aキーを押す
↓
KeyDown
↓
KeyPress
↓
Aキーを離す
↓
KeyUp

ただし、すべてのキーでKeyPressが発生するわけではありません。KeyPressは文字入力に関係するイベントなので、Ctrlキー、Shiftキー、Altキー、矢印キー、ファンクションキーなどでは発生しない場合があります。

一方、KeyDownとKeyUpは、特殊キーを含む多くのキーで発生します。

7-2. KeyDownとKeyPressの違い

KeyDownとKeyPressの大きな違いは、「キー」を扱うか「文字」を扱うかです。

KeyDownは、どのキーが押されたかを扱います。

C#
private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        MessageBox.Show("Enterキー");
    }
}

KeyPressは、どの文字が入力されたかを扱います。

C#
private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
{
    if (char.IsDigit(e.KeyChar))
    {
        MessageBox.Show("数字が入力されました");
    }
}

たとえば、Shift＋Aを押した場合、KeyDownでは「Aキーが押された」と判定します。一方、KeyPressでは入力文字として「A」を扱います。

数字だけ入力させたい、特定の文字を入力禁止にしたい、といった文字入力制御ではKeyPressが使われることがあります。

ただし、日本語入力や貼り付け入力、IME変換などを考慮すると、KeyPressだけで入力制御を完結させるのは難しい場合があります。

7-3. KeyDownとKeyUpの違い

KeyDownはキーを押したときに発生し、KeyUpはキーを離したときに発生します。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    label1.Text = "キーが押されました";
}

private void Form1_KeyUp(object sender, KeyEventArgs e)
{
    label1.Text = "キーが離されました";
}

ゲームや操作画面では、KeyDownとKeyUpを組み合わせて「押している間だけ移動する」という処理を作ることがあります。

C#
private bool isRightPressed = false;

private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Right)
    {
        isRightPressed = true;
    }
}

private void Form1_KeyUp(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Right)
    {
        isRightPressed = false;
    }
}

KeyDownだけを使うと、キーを長押ししたときに連続してイベントが発生することがあります。押下状態を管理したい場合は、KeyUpも併用すると安定します。

7-4. KeyPressが向いているケース

KeyPressは、文字入力を扱いたい場合に向いています。

代表的な用途は次のとおりです。

数字だけ入力させたい
英数字だけ入力させたい
特定の記号を入力禁止にしたい
入力された文字を判定したい

たとえば、TextBoxに数字だけ入力させる簡単な例は次のとおりです。

C#
private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
{
    if (!char.IsControl(e.KeyChar) && !char.IsDigit(e.KeyChar))
    {
        e.Handled = true;
    }
}

このコードでは、制御文字と数字以外の入力を拒否しています。

ただし、右クリック貼り付けやIME入力、ドラッグ＆ドロップ、プログラムからの代入などはKeyPressだけでは完全に制御できないことがあります。

厳密な入力検証が必要な場合は、TextChanged、Validating、入力後のバリデーションも組み合わせましょう。

7-5. KeyDownが向いているケース

KeyDownは、キー操作やショートカットキーを扱いたい場合に向いています。

代表的な用途は次のとおりです。

Enterキーで処理を実行する
Escキーでキャンセルする
Ctrl＋Sで保存する
F1キーでヘルプを表示する
矢印キーで移動する
ShiftやCtrlとの組み合わせを判定する
キーを押した瞬間に処理したい

たとえば、Ctrl＋Sの判定はKeyDownが向いています。

C#
private void Form1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.Control && e.KeyCode == Keys.S)
    {
        SaveFile();
        e.SuppressKeyPress = true;
    }
}

特殊キーや修飾キーを扱うなら、基本的にはKeyDownを使うと覚えておくとよいでしょう。

7-6. KeyPressが非推奨・使いにくい場面

KeyPressは便利ですが、すべてのキー入力に向いているわけではありません。

特に次のような場面では使いにくいです。

CtrlキーやShiftキーを判定したい
矢印キーを判定したい
ファンクションキーを判定したい
ショートカットキーを実装したい
キーを押した瞬間と離した瞬間を分けたい
IME入力や日本語入力を厳密に扱いたい
貼り付け入力も含めて入力制限したい