Andy De George
c0ba284473
* Merge winforms framework content to working branch (#14) * Breadcrumb / TOC / Move net5 to net folder (#15) * change path from net5 to net * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Add .net 5 winforms placeholder article (#16) * added some metadata and adjusted net5 placeholder * corrections * corrections * corrections * Test1 * Swapping landing page vs concept * fix links * Fix links * Fix desc
4.4 KiB
title, ms.date, helpviewer_keywords, ms.assetid
| title | ms.date | helpviewer_keywords | ms.assetid | ||||||
|---|---|---|---|---|---|---|---|---|---|
| Using Keyboard Events | 03/30/2017 |
|
d3f3e14b-a459-4ee6-9875-8957e34f8ee9 |
Using Keyboard Events
Most Windows Forms programs process keyboard input by handling the keyboard events. This topic provides an overview of the keyboard events, including details on when to use each event and the data that is supplied for each event. Also see Event Handlers Overview (Windows Forms) and Events Overview (Windows Forms).
Keyboard Events
Windows Forms provides two events that occur when a user presses a keyboard key and one event when a user releases a keyboard key:
-
The xref:System.Windows.Forms.Control.KeyDown event occurs once
-
The xref:System.Windows.Forms.Control.KeyPress event, which can occur multiple times when a user holds down the same key.
-
The xref:System.Windows.Forms.Control.KeyUp event occurs once when a user releases a key.
When a user presses a key, Windows Forms determines which event to raise based on whether the keyboard message specifies a character key or a physical key. For more information about character and physical keys, see How Keyboard Input Works.
The following table describes the three keyboard events.
| Keyboard event | Description | Results |
|---|---|---|
| xref:System.Windows.Forms.Control.KeyDown | This event is raised when a user presses a physical key. | The handler for xref:System.Windows.Forms.Control.KeyDown receives:
|
| xref:System.Windows.Forms.Control.KeyPress | This event is raised when the key or keys pressed result in a character. For example, a user presses SHIFT and the lowercase "a" keys, which result in a capital letter "A" character. | xref:System.Windows.Forms.Control.KeyPress is raised after xref:System.Windows.Forms.Control.KeyDown.
|
| xref:System.Windows.Forms.Control.KeyUp | This event is raised when a user releases a physical key. | The handler for xref:System.Windows.Forms.Control.KeyUp receives:
|