Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

UIElement.OnKeyDown-Methode

Aktualisiert: November 2007

Wird aufgerufen, wenn ein nicht behandeltes angefügtes Ereignis Keyboard.KeyDown auf seiner Route ein Element erreicht, das von dieser Klasse abgeleitet ist. Implementieren Sie diese Methode, um eine Klassenbehandlung für dieses Ereignis hinzuzufügen.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

protected virtual void OnKeyDown(
	KeyEventArgs e
)
protected void OnKeyDown(
	KeyEventArgs e
)
protected function OnKeyDown(
	e : KeyEventArgs
)
Sie können diese Methoden nicht in XAML verwenden.

Parameter

e
Typ: System.Windows.Input.KeyEventArgs
Die Instanz von KeyEventArgs, die die Ereignisdaten enthält.

Tastatureingaben werden von einem speziellen Eingabe-Manager behandelt. Andere Programmierfeatures, die von Tastatureingaben abhängig sind, beispielsweise Eingaben und Befehlsbindungen, behandeln die Tastatureingabe u. U. vor deren Verfügbarmachung als allgemeine Tastatureingabe. Wenn diese Eingabesystemfeatures das Ereignis als behandelt markieren, wird OnKeyDown nicht aufgerufen.

Diese Methode verfügt über keine Standardimplementierung. Da diese Methode von einer Zwischenklasse in der Vererbung implementiert werden kann, empfiehlt es sich, die Basisimplementierung in der Implementierung aufzurufen.

Der Zweck dieser Methode entspricht weitestgehend den On*-Methoden des common language runtime (CLR)-Ereignismustern: Diese Methode bietet Möglichkeiten für das Behandeln des entsprechenden Ereignisses in abgeleiteten Klassen durch das Festlegen eines Klassenhandlers anstelle eines Instanzhandlers. In diesem Fall ist das entsprechende Ereignis ein Routingereignis. Das Implementierungsmuster der On*-Methoden für Routingereignisse ist abweichend, da ein Routingereignis von einem untergeordneten Element ausgelöst werden kann, wobei es sich nicht unbedingt um das Element handeln muss, das die Handler aufruft. Deshalb muss die Implementierung die Quelleigenschaften der Ereignisdaten untersuchen. In den meisten Fällen sollte nicht versucht werden, das Ereignis erneut auszulösen.

Durch das Überschreiben dieser Methode oder durch das Registrieren von Klassenhandlern bei RegisterClassHandler können abgeleitete Klassen von UIElement private Klassenhandlermethoden aufrufen, wenn das Ereignis entlang der Ereignisroute empfangen wird. Die Klassenbehandlung ist beispielsweise in einem Szenario angemessen, in dem die Ereignisdaten geändert werden und das Routingereignis als behandelt markiert wird.

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0
Anzeigen: