Freigeben über


Verwenden von Tastaturereignissen

Die meisten Windows Forms-Programme verarbeiten Tastatureingaben, indem die Tastaturereignisse behandelt werden. Dieses Thema enthält eine Übersicht über die Tastaturereignisse, einschließlich Details darüber, wann jedes Ereignis verwendet werden sollte und welche Daten für jedes Ereignis verfügbar sind. Siehe Auch Ereignishandlers Übersicht (Windows Forms) und Ereignisse Übersicht (Windows Forms).

Tastaturereignisse

Windows Forms stellt zwei Ereignisse bereit, die auftreten, wenn ein Benutzer eine Tastaturtaste drückt, und ein Ereignis, das auftritt, wenn ein Benutzer eine Tastaturtaste loslässt.

  • Das KeyDown-Ereignis tritt einmal auf

  • Das KeyPress-Ereignis, das mehrmals auftreten kann, wenn ein Benutzer denselben Schlüssel gedrückt hält.

  • Das KeyUp-Ereignis tritt einmal auf, wenn ein Benutzer einen Schlüssel loslässt.

Wenn ein Benutzer eine Taste drückt, bestimmt Windows Forms, welches Ereignis ausgelöst werden soll, basierend darauf, ob die Tastaturmeldung eine Zeichentaste oder eine physische Taste angibt. Weitere Informationen zu Zeichen und physischen Tasten finden Sie unter „Wie Tastatureingaben funktionieren“.

In der folgenden Tabelle werden die drei Tastaturereignisse beschrieben.

Tastaturereignis Beschreibung Ergebnisse
KeyDown Dieses Ereignis wird ausgelöst, wenn ein Benutzer eine physische Taste drückt. Der Handler für KeyDown empfängt:

  • Ein KeyEventArgs-Parameter, der die eigenschaft KeyCode bereitstellt (die eine physische Tastaturtaste angibt).
  • Die Modifiers-Eigenschaft (UMSCHALT, STRG oder ALT).
  • Die KeyData-Eigenschaft (die den Schlüsselcode und den Modifizierer kombiniert). Der parameter KeyEventArgs bietet außerdem Folgendes:

    • Die Handled-Eigenschaft, die festgelegt werden kann, um zu verhindern, dass das zugrunde liegende Steuerelement den Schlüssel empfängt.
    • Die SuppressKeyPress-Eigenschaft kann verwendet werden, um die Ereignisse KeyPress und KeyUp für diesen Tastenanschlag zu unterdrücken.
KeyPress Dieses Ereignis wird ausgelöst, wenn durch das Drücken einer oder mehrerer Tasten ein Zeichen erzeugt wird. Beispielsweise drückt ein Benutzer die UMSCHALT-Taste und die Taste für das Kleinbuchstaben "a", wodurch der Großbuchstabe "A" erzeugt wird. KeyPress wird nach KeyDownausgelöst.

  • Der Handler für KeyPress empfängt:
  • Ein KeyPressEventArgs Parameter, der den Zeichencode der gedrückten Taste enthält. Dieser Zeichencode ist für jede Kombination aus einer Zeichentaste und einer Zusatztaste eindeutig.

    Der Schlüssel "A" generiert z. B. Folgendes:

    • Der Zeichencode 65, wenn er mit der UMSCHALTTASTE gedrückt wird
    • Oder die FESTSTELLTASTE, 97, wenn sie selbst gedrückt wird,
    • Und 1, wenn sie mit der STRG-TASTE gedrückt wird.
KeyUp Dieses Ereignis wird ausgelöst, wenn ein Benutzer einen physischen Schlüssel loslässt. Der Handler für KeyUp empfängt:

  • Ein KeyEventArgs Parameter:

    • Dies stellt die KeyCode-Eigenschaft bereit (die eine physische Taste auf der Tastatur angibt).
    • Die Modifiers-Eigenschaft (Umschalt, Strg oder Alt).
    • Die KeyData-Eigenschaft (die den Schlüsselcode und den Modifizierer kombiniert).

Siehe auch