UIElement.KeyDown Ereignis
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.
Tritt auf, wenn eine Tastaturtaste gedrückt wird, während das UIElement den Fokus hat.
public:
virtual event KeyEventHandler ^ KeyDown;// Register
event_token KeyDown(KeyEventHandler const& handler) const;
// Revoke with event_token
void KeyDown(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::KeyDown_revoker KeyDown(auto_revoke_t, KeyEventHandler const& handler) const;public event KeyEventHandler KeyDown;function onKeyDown(eventArgs) { /* Your code */ }
uIElement.addEventListener("keydown", onKeyDown);
uIElement.removeEventListener("keydown", onKeyDown);
- or -
uIElement.onkeydown = onKeyDown;Public Custom Event KeyDown As KeyEventHandler <uiElement KeyDown="eventhandler"/>
Ereignistyp
Hinweise
Die Steuerelemente der UI generieren nur dann Tastaturereignisse, wenn sie den Eingabefokus aufweisen. Standardmäßig erhält das System den Fokus für das erste fokussierbare Element in der visuellen Struktur. Ein einzelnes Steuerelement erhält den Fokus, wenn der Benutzer im Layout direkt auf dieses Steuerelement klickt oder tippt oder die TAB-TASTE verwendet, um in eine Registerkartensequenz innerhalb des Inhaltsbereichs zu wechseln. Sie können Steuerelemente auch programmgesteuert fokussieren, indem Sie UIElement.Focus(Microsoft.UI.Xaml.FocusState) aufrufen.
KeyDown ist ein Routingereignis. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
KeyDown verwendet KeyRoutedEventArgs-Ereignisdaten . Die relevantesten Eigenschaften von KeyRoutedEventArgs für die meisten Handlerszenarien sind Key und möglicherweise KeyStatus. Weitere Informationen zur Behandlung von Tastaturereignissen, einschließlich Beispielcode zum Definieren einer KeyEventHandler-Methode , finden Sie unter Tastaturinteraktionen.
Ein Szenario für die Behandlung von Tastaturereignissen besteht darin, Zugriffstasten oder Zugriffstasten für eine App oder eine Region oder ein Steuerelement innerhalb einer App zu unterstützen. Weitere Informationen zu diesem Szenario finden Sie unter Tastaturzugriff.
Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das KeyDown-Eingabeereignis. Wenn dies der Grund ist, verfügt das Steuerelement wahrscheinlich über eine Außerkraftsetzung für die OnKeyDown-Methode. In der Regel sollen diese Klassenhandler eine Teilmenge von Tastendrücken verarbeiten, die eine tastaturbasierte Benutzerinteraktion mit diesem Steuerelement ermöglichen. Häufig unterstützt diese Interaktion ein Tastaturzugriffsfeature. Wenn ein Tastendruck von der klassenbasierten Behandlung behandelt wird, gilt das Drücken der Taste als bereits verarbeitet, und das KeyDown-Ereignis wird für die Behandlung durch keine Benutzercodehandler für dieses Steuerelement speziell für diese Taste ausgelöst. In der Regel ist dies nur für einige dedizierte Schlüssel. Beispielsweise verfügt ButtonBase über eine Klassenbehandlung, sodass die LEERTASTE und die EINGABETASTE als Tastaturäquivalente für das Aufrufen der Schaltfläche behandelt werden. Dies bietet eine integrierte Tastaturäquivalent zum Tippen oder Klicken auf die Schaltfläche mit einer Maus und ermöglicht das Barrierefreiheitsszenario, in dem die Benutzeroberfläche und die Schaltfläche nur über eine Tastatur verwendet werden. Aber alle anderen Schlüssel außer Leerzeichen oder EINGABETASTE lösen weiterhin ein KeyDown- und KeyUp-Ereignis für ein aus Button. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung von Ereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
KeyDown unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als Behandelt gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.