Control.KeyDown イベント

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

Control.cs

コントロールにフォーカスがあるときにキーが押されると発生します。

C#

public event System.Windows.Forms.KeyEventHandler? KeyDown;

イベントの種類

KeyEventHandler

例

次のコード例では、 イベントを KeyDown 使用して、コントロールに入力された文字の種類を決定します。

C#

// Boolean flag used to determine when a character other than a number is entered.
private bool nonNumberEntered = false;

// Handle the KeyDown event to determine the type of character entered into the control.
private void textBox1_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e)
{
    // Initialize the flag to false.
    nonNumberEntered = false;

    // Determine whether the keystroke is a number from the top of the keyboard.
    if (e.KeyCode < Keys.D0 || e.KeyCode > Keys.D9)
    {
        // Determine whether the keystroke is a number from the keypad.
        if (e.KeyCode < Keys.NumPad0 || e.KeyCode > Keys.NumPad9)
        {
            // Determine whether the keystroke is a backspace.
            if(e.KeyCode != Keys.Back)
            {
                // A non-numerical keystroke was pressed.
                // Set the flag to true and evaluate in KeyPress event.
                nonNumberEntered = true;
            }
        }
    }
    //If shift key was pressed, it's not a number.
    if (Control.ModifierKeys == Keys.Shift) {
        nonNumberEntered = true;
    }
}

// This event occurs after the KeyDown event and can be used to prevent
// characters from entering the control.
private void textBox1_KeyPress(object sender, System.Windows.Forms.KeyPressEventArgs e)
{
    // Check for the flag being set in the KeyDown event.
    if (nonNumberEntered)
    {
        // Stop the character from being entered into the control since it is non-numerical.
        e.Handled = true;
    }
}

次のコード例では、イベントをKeyDownKeyUpKeyPress発生させる順序、およびイベント ハンドラーを登録する方法を示します。

C#

public partial class Form2 : Form
{
    public Form2()
    {
        InitializeComponent();
        textBox2.Multiline = true;
        textBox2.ScrollBars = ScrollBars.Both;

        //Setup events that listens on keypress
        textBox1.KeyDown += TextBox1_KeyDown;
        textBox1.KeyPress += TextBox1_KeyPress;
        textBox1.KeyUp += TextBox1_KeyUp;
    }

    // Handle the KeyUp event to print the type of character entered into the control.
    private void TextBox1_KeyUp(object sender, KeyEventArgs e)
    {
        textBox2.AppendText( $"KeyUp code: {e.KeyCode}, value: {e.KeyValue}, modifiers: {e.Modifiers}" + "\r\n");
    }

    // Handle the KeyPress event to print the type of character entered into the control.
    private void TextBox1_KeyPress(object sender, KeyPressEventArgs e)
    {
        textBox2.AppendText( $"KeyPress keychar: {e.KeyChar}" + "\r\n");
    }

    // Handle the KeyDown event to print the type of character entered into the control.
    private void TextBox1_KeyDown(object sender, KeyEventArgs e)
    {
        textBox2.AppendText( $"KeyDown code: {e.KeyCode}, value: {e.KeyValue}, modifiers: {e.Modifiers}" + "\r\n");
    }
}

注釈

キー イベントは次の順序で発生します。

1. KeyDown

2. KeyPress

3. KeyUp

フォーム レベルでのみキーボード イベントを処理し、他のコントロールがキーボード イベントを受信できるようにするには、フォームのイベント処理メソッドの KeyPress プロパティを にtrue設定KeyPressEventArgs.Handledします。 TAB キー、RETURN キー、ESC キー、方向キーなどの特定のキーは、コントロールによって自動的に処理されます。 これらのキーでイベントを KeyDown 発生させるには、フォームの各コントロールの メソッドをオーバーライド IsInputKey する必要があります。 のオーバーライドの IsInputKey コードでは、特殊なキーのいずれかが押されているかどうかを判断し、 の true値を返す必要があります。 メソッドをオーバーライドする IsInputKey 代わりに、 イベントを PreviewKeyDown 処理し、 プロパティを IsInputKey に true設定できます。 コード例については、 イベントを PreviewKeyDown 参照してください。

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。

適用対象

こちらもご覧ください

• KeyEventArgs
• KeyEventHandler
• OnKeyDown(KeyEventArgs)
• KeyUp
• KeyPress
• PreviewKeyDown