Keys Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt Tastencodes und Modifizierer an.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class Keys
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))]
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
public enum Keys
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))]
[System.Flags]
public enum Keys
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))>]
[<System.Flags>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Keys =
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))>]
[<System.Flags>]
type Keys =
Public Enum Keys
- Vererbung
- Attribute
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| Modifiers | -65536 | Die Bitmaske zum Extrahieren von Modifizierern aus einem Schlüsselwert. |
| None | 0 | Keine Taste gedrückt. |
| LButton | 1 | Die linke Maustaste. |
| RButton | 2 | Die rechte Maustaste. |
| Cancel | 3 | DIE ABBRECHEN-TASTE. |
| MButton | 4 | Die mittlere Maustaste (Drei-Tasten-Maus). |
| XButton1 | 5 | Die erste x-Maustaste (Fünf-Tasten-Maus). |
| XButton2 | 6 | Die zweite x-Maustaste (Fünf-Tasten-Maus). |
| Back | 8 | RÜCKTASTE. |
| Tab | 9 | TAB-TASTE. |
| LineFeed | 10 | Die LINEFEED-TASTE. |
| Clear | 12 | DIE ENTF-TASTE. |
| Enter | 13 | Die EINGABETASTE. |
| Return | 13 | DIE EINGABETASTE. |
| ShiftKey | 16 | UMSCHALTTASTE. |
| ControlKey | 17 | STRG-TASTE. |
| Menu | 18 | ALT-TASTE. |
| Pause | 19 | PAUSE-TASTE. |
| Capital | 20 | FESTSTELLTASTE. |
| CapsLock | 20 | FESTSTELLTASTE. |
| HanguelMode | 21 | Die IME Hanguel-Modustaste. (aus Gründen der Kompatibilität beibehalten; Verwendung |
| HangulMode | 21 | Die IME Hangul-Modustaste. |
| KanaMode | 21 | Die IME Kana-Modustaste. |
| JunjaMode | 23 | Die IME Junja-Modustaste. |
| FinalMode | 24 | Die IME-Taste für den endgültigen Modus. |
| HanjaMode | 25 | Die IME Hanja-Modustaste. |
| KanjiMode | 25 | Die IME Kanji-Modustaste. |
| Escape | 27 | ESC-TASTE. |
| IMEConvert | 28 | Der IME-Konvertierungsschlüssel. |
| IMENonconvert | 29 | Der NICHTkonvertierte IME-Schlüssel. |
| IMEAccept | 30 | Der IME-Annahmeschlüssel ersetzt IMEAceept. |
| IMEAceept | 30 | Der IME-Akzepteschlüssel. Veraltet, verwenden Sie IMEAccept stattdessen. |
| IMEModeChange | 31 | Der IME-Modus ändert die Taste. |
| Space | 32 | LEERTASTE. |
| PageUp | 33 | BILD-AUF-TASTE. |
| Prior | 33 | BILD-AUF-TASTE. |
| Next | 34 | BILD-AB-TASTE. |
| PageDown | 34 | BILD-AB-TASTE. |
| End | 35 | ENDE-TASTE. |
| Home | 36 | POS1-TASTE. |
| Left | 37 | DIE NACH-LINKS-TASTE. |
| Up | 38 | DIE NACH-OBEN-TASTE. |
| Right | 39 | DIE NACH-RECHTS-TASTE. |
| Down | 40 | DIE NACH-UNTEN-TASTE. |
| Select | 41 | Die SELECT-TASTE. |
| 42 | Die DRUCKTASTE. |
|
| Execute | 43 | Die EXECUTE-TASTE. |
| PrintScreen | 44 | DIE DRUCKTASTE. |
| Snapshot | 44 | DIE DRUCKTASTE. |
| Insert | 45 | DIE INS-TASTE. |
| Delete | 46 | ENTF-TASTE. |
| Help | 47 | Der HILFE-Schlüssel. |
| D0 | 48 | 0-TASTE. |
| D1 | 49 | 1-TASTE. |
| D2 | 50 | 2-TASTE. |
| D3 | 51 | 3-TASTE. |
| D4 | 52 | 4-TASTE. |
| D5 | 53 | 5-TASTE. |
| D6 | 54 | 6-TASTE. |
| D7 | 55 | 7-TASTE. |
| D8 | 56 | 8-TASTE. |
| D9 | 57 | 9-TASTE. |
| A | 65 | A-TASTE. |
| B | 66 | B-TASTE. |
| C | 67 | C-TASTE. |
| D | 68 | D-TASTE. |
| E | 69 | E-TASTE. |
| F | 70 | F-TASTE. |
| G | 71 | G-TASTE. |
| H | 72 | H-TASTE. |
| I | 73 | I-TASTE. |
| J | 74 | J-TASTE. |
| K | 75 | K-TASTE. |
| L | 76 | L-TASTE. |
| M | 77 | M-TASTE. |
| N | 78 | N-TASTE. |
| O | 79 | O-TASTE. |
| P | 80 | P-TASTE. |
| Q | 81 | Q-TASTE. |
| R | 82 | R-TASTE. |
| S | 83 | S-TASTE. |
| T | 84 | T-TASTE. |
| U | 85 | U-TASTE. |
| V | 86 | V-TASTE. |
| W | 87 | W-TASTE. |
| X | 88 | X-TASTE. |
| Y | 89 | Y-TASTE. |
| Z | 90 | Z-TASTE. |
| LWin | 91 | Die linke Windows Logo-Taste (Microsoft natürliche Tastatur). |
| RWin | 92 | Die rechte Windows Logo-Taste (Microsoft natürliche Tastatur). |
| Apps | 93 | Die Anwendungstaste (Microsoft natürliche Tastatur). |
| Sleep | 95 | Der Computer für den Standbymodus. |
| NumPad0 | 96 | Die TASTE 0 auf der Zehnertastatur. |
| NumPad1 | 97 | Die Taste 1 auf der Zehnertastatur. |
| NumPad2 | 98 | Die 2-Taste auf der Zehnertastatur. |
| NumPad3 | 99 | Die 3-TASTE auf der Zehnertastatur. |
| NumPad4 | 100 | Die 4-TASTE auf der Zehnertastatur. |
| NumPad5 | 101 | Die 5-TASTE auf der Zehnertastatur. |
| NumPad6 | 102 | Die 6-TASTE auf der Zehnertastatur. |
| NumPad7 | 103 | Die 7-TASTE auf der Zehnertastatur. |
| NumPad8 | 104 | Die 8-TASTE auf der Zehnertastatur. |
| NumPad9 | 105 | Die 9-TASTE auf der Zehnertastatur. |
| Multiply | 106 | Der Multiplizierschlüssel. |
| Add | 107 | Die Add-Taste. |
| Separator | 108 | Die Trenntaste. |
| Subtract | 109 | Der Subtrahieren des Schlüssels. |
| Decimal | 110 | Der Dezimalschlüssel. |
| Divide | 111 | Die Trenntaste. |
| F1 | 112 | F1-TASTE. |
| F2 | 113 | F2-TASTE. |
| F3 | 114 | F3-TASTE. |
| F4 | 115 | F4-TASTE. |
| F5 | 116 | F5-TASTE. |
| F6 | 117 | F6-TASTE. |
| F7 | 118 | F7-TASTE. |
| F8 | 119 | F8-TASTE. |
| F9 | 120 | F9-TASTE. |
| F10 | 121 | F10-TASTE. |
| F11 | 122 | F11-TASTE. |
| F12 | 123 | F12-TASTE. |
| F13 | 124 | F13-TASTE. |
| F14 | 125 | F14-TASTE. |
| F15 | 126 | F15-TASTE. |
| F16 | 127 | F16-TASTE. |
| F17 | 128 | F17-TASTE. |
| F18 | 129 | F18-TASTE. |
| F19 | 130 | F19-TASTE. |
| F20 | 131 | F20-TASTE. |
| F21 | 132 | F21-TASTE. |
| F22 | 133 | F22-TASTE. |
| F23 | 134 | F23-TASTE. |
| F24 | 135 | F24-TASTE. |
| NumLock | 144 | DIE NUM-TASTE. |
| Scroll | 145 | ROLLEN-TASTE. |
| LShiftKey | 160 | Die linke UMSCHALTTASTE. |
| RShiftKey | 161 | Die rechte UMSCHALTTASTE. |
| LControlKey | 162 | Die linke STRG-TASTE. |
| RControlKey | 163 | Die rechte STRG-TASTE. |
| LMenu | 164 | Die linke ALT-TASTE. |
| RMenu | 165 | Die rechte ALT-TASTE. |
| BrowserBack | 166 | Die Zurück-TASTE des Browsers. |
| BrowserForward | 167 | Der Vorwärtsschlüssel des Browsers. |
| BrowserRefresh | 168 | Der Aktualisierungsschlüssel des Browsers. |
| BrowserStop | 169 | Die Stopptaste des Browsers. |
| BrowserSearch | 170 | Der Browsersuchschlüssel. |
| BrowserFavorites | 171 | Der Schlüssel "Browserfavoriten". |
| BrowserHome | 172 | Der Browserstartschlüssel. |
| VolumeMute | 173 | Die Taste "Lautstärke stummschalten". |
| VolumeDown | 174 | Die Leisertaste. |
| VolumeUp | 175 | Die Lautertaste. |
| MediaNextTrack | 176 | Die nächste Titeltaste für Medien. |
| MediaPreviousTrack | 177 | Die vorherige Titeltaste des Mediums. |
| MediaStop | 178 | Die Medienstopptaste. |
| MediaPlayPause | 179 | Die Medienwiedergabe-Taste "Pause". |
| LaunchMail | 180 | Der E-Mail-Startschlüssel. |
| SelectMedia | 181 | Die Medientaste auswählen. |
| LaunchApplication1 | 182 | Die Startanwendung mit einem Schlüssel. |
| LaunchApplication2 | 183 | Die Startanwendung mit zwei Schlüsseln. |
| Oem1 | 186 | Oem 1-Taste. |
| OemSemicolon | 186 | Die OEM-Semikolonstaste auf einer US-Standardtastatatur. |
| Oemplus | 187 | Der OEM plus-Taste auf einer beliebigen Landes-/Regionstastaturen. |
| Oemcomma | 188 | Die OEM-Kommataste auf einer beliebigen Landes-/Regionstastaturen. |
| OemMinus | 189 | Die OEM-Minustaste auf einer beliebigen Landes-/Regionstastaturen. |
| OemPeriod | 190 | Die OEM-Punkttaste auf einer beliebigen Länder-/Regionstastaturen. |
| Oem2 | 191 | Der OEM 2-Schlüssel. |
| OemQuestion | 191 | Die OEM-Fragezeichentaste auf einer US-Standardtastaturen. |
| Oem3 | 192 | Der OEM 3-Schlüssel. |
| Oemtilde | 192 | Die OEM-Tildetaste auf einer US-Standardtastaturen. |
| Oem4 | 219 | Der OEM 4-Schlüssel. |
| OemOpenBrackets | 219 | Die offene Klammertaste des OEM auf einer US-Standardtastaturen. |
| Oem5 | 220 | Der OEM 5-Schlüssel. |
| OemPipe | 220 | Die OEM-Pipetaste auf einer US-Standardtastatur. |
| Oem6 | 221 | Der OEM 6-Schlüssel. |
| OemCloseBrackets | 221 | Der OEM schließt die eckige Klammertaste auf einer US-Standardtastaturen. |
| Oem7 | 222 | Der OEM 7-Schlüssel. |
| OemQuotes | 222 | Der OEM-Einzel-/Doppelte Anführungszeichentaste auf einer US-Standardtastatatur. |
| Oem8 | 223 | Der OEM 8-Schlüssel. |
| Oem102 | 226 | Der OEM 102-Schlüssel. |
| OemBackslash | 226 | Die OEM-Winkelklammer oder umgekehrte Schrägstrichtaste auf der RT 102-Tastentastaturen. |
| ProcessKey | 229 | DIE PROZESSTASTE. |
| Packet | 231 | Wird verwendet, um Unicode-Zeichen so zu übergeben, als wären sie Tastaturanschläge. Der Paketschlüsselwert ist das niedrige Wort eines 32-Bit-Werts für virtuelle Schlüssel, der für Eingabemethoden ohne Tastatur verwendet wird. |
| Attn | 246 | DIE ATTN-TASTE. |
| Crsel | 247 | Die CRSEL-TASTE. |
| Exsel | 248 | Die EXSEL-TASTE. |
| EraseEof | 249 | Die EOF-TASTE LÖSCHEN. |
| Play | 250 | Die PLAY-TASTE. |
| Zoom | 251 | Zoomtaste. |
| NoName | 252 | Eine Konstante, die für die zukünftige Verwendung reserviert ist. |
| Pa1 | 253 | Pa1-Taste. |
| OemClear | 254 | DIE ENTF-TASTE. |
| KeyCode | 65535 | Die Bitmaske zum Extrahieren eines Schlüsselcodes aus einem Schlüsselwert. |
| Shift | 65536 | Umschalttaste. |
| Control | 131072 | Die STRG-Modifizierertaste. |
| Alt | 262144 | Die ALT-Modifizierertaste. |
Beispiele
Im folgenden Codebeispiel wird das KeyDown Ereignis verwendet, um den Typ des Zeichens zu bestimmen, der in das Steuerelement eingegeben wurde.
// Boolean flag used to determine when a character other than a number is entered.
private:
bool nonNumberEntered;
// Handle the KeyDown event to determine the type of character entered into the control.
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.
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;
}
}
// 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;
}
}
' Boolean flag used to determine when a character other than a number is entered.
Private nonNumberEntered As Boolean = False
' Handle the KeyDown event to determine the type of character entered into the control.
Private Sub textBox1_KeyDown(sender As Object, e As System.Windows.Forms.KeyEventArgs) _
Handles textBox1.KeyDown
' 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 OrElse e.KeyCode > Keys.D9 Then
' Determine whether the keystroke is a number from the keypad.
If e.KeyCode < Keys.NumPad0 OrElse e.KeyCode > Keys.NumPad9 Then
' Determine whether the keystroke is a backspace.
If e.KeyCode <> Keys.Back Then
' A non-numerical keystroke was pressed.
' Set the flag to true and evaluate in KeyPress event.
nonNumberEntered = True
End If
End If
End If
'If shift key was pressed, it's not a number.
If Control.ModifierKeys = Keys.Shift Then
nonNumberEntered = true
End If
End Sub
' This event occurs after the KeyDown event and can be used
' to prevent characters from entering the control.
Private Sub textBox1_KeyPress(sender As Object, e As System.Windows.Forms.KeyPressEventArgs) _
Handles textBox1.KeyPress
' Check for the flag being set in the KeyDown event.
If nonNumberEntered = True Then
' Stop the character from being entered into the control since it is non-numerical.
e.Handled = True
End If
End Sub
Hinweise
Die Keys Klasse enthält Konstanten für die Verarbeitung von Tastatureingaben. Die Member der Keys-Aufzählung bestehen aus einem Schlüsselcode und einer Reihe von Modifizierern, die in einem einzelnen ganzzahligen Wert kombiniert werden. In der Win32-Anwendungsprogrammierschnittstelle (API) weist ein Schlüsselwert zwei Hälften auf, wobei die Hochreihenfolgebits den Schlüsselcode enthalten (die mit einem Windows virtuellen Schlüsselcode identisch sind) und die Bits mit niedriger Reihenfolge, die Schlüsselmodifizierer wie UMSCHALT-, CTRL- und ALT-Tasten darstellen.
Warning
Verwenden Sie die Werte in dieser Enumeration nicht für kombinierte bitweise Vorgänge. Die Werte in der Enumeration schließen sich nicht gegenseitig aus.
Note
Diese Aufzählung bietet keine Möglichkeit, zu testen, ob die FESTSTELLTASTE oder DIE NUM-TASTE derzeit aktiviert sind. Sie können eine der folgenden Techniken verwenden, um zu ermitteln, ob diese Schlüssel aktiviert sind:
Rufen Sie die IsKeyLocked Methode der Control Klasse auf.
Verwenden Sie zur feineren Kontrolle die Windows API-Funktionen
GetKeyState,GetAsyncKeyStateoderGetKeyboardState, die in user32.dlldefiniert sind. Weitere Informationen zum Aufrufen systemeigener Funktionen finden Sie unter Verwenden nicht verwalteter DLL-Funktionen.
In der folgenden Tabelle sind die Schlüsselcodewerte aufgeführt, die durch zwei aufgezählte Werte dargestellt werden, die sowohl die allgemeinen OEM-Tasten (Original Equipment Manufacturer) als auch die spezifischeren US-Tastaturzuordnungen darstellen.
| Hexadezimalwert | US-Tastatur | Allgemeiner OEM |
|---|---|---|
| B.A. | OemSemicolon | Oem1 |
| BF | OemQuestion | Oem2 |
| C0 | Oemtilde | Oem3 |
| Deutsche Bahn | OemOpenBrackets | Oem4 |
| DC | OemPipe | Oem5 |
| DD | OemCloseBrackets | Oem6 |
| DE | OemQuotes | Oem7 |
| E2 | OemBackslash | Oem102 |
Vorsicht
Für .NET Framework 2.0 wurde ein Element IMEAccept hinzugefügt, das den vorherigen Eintrag ersetzt, IMEAceept, der falsch geschrieben wurde. Die ältere Version wurde aus Gründen der Abwärtskompatibilität beibehalten, kann aber in zukünftigen Versionen von .NET gelöscht werden.