UIElement.KeyUp 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 losgelassen wird, während das UIElement den Fokus hat.
public:
virtual event KeyEventHandler ^ KeyUp;// Register
event_token KeyUp(KeyEventHandler const& handler) const;
// Revoke with event_token
void KeyUp(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::KeyUp_revoker KeyUp(auto_revoke_t, KeyEventHandler const& handler) const;public event KeyEventHandler KeyUp;function onKeyUp(eventArgs) { /* Your code */ }
uIElement.addEventListener("keyup", onKeyUp);
uIElement.removeEventListener("keyup", onKeyUp);
- or -
uIElement.onkeyup = onKeyUp;Public Custom Event KeyUp As KeyEventHandler <uiElement KeyUp="eventhandler"/>
Ereignistyp
Hinweise
Steuerelemente in der Benutzeroberfläche generieren Tastaturereignisse nur, wenn sie den Eingabefokus haben. Standardmäßig erhält das erste fokussierbare Element in der visuellen Struktur den Fokus des Systems. 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 innerhalb des Inhaltsbereichs in eine Tabreihenfolge zu wechseln. Sie können Steuerelemente auch programmgesteuert fokussieren, indem Sie UIElement.Focus(Microsoft) aufrufen. BENUTZEROBERFLÄCHE. Xaml.FocusState).
KeyUp ist ein Routingereignis. Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".
KeyUp verwendet KeyRoutedEventArgs-Ereignisdaten . Die relevantesten Eigenschaften für KeyRoutedEventArgs die meisten Handlerszenarien sind Key und möglicherweise KeyStatus. Weitere Informationen zum Behandeln 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 Tastenkombinationen für eine App oder eine Region oder ein Steuerelement in einer App zu unterstützen. Weitere Informationen zu diesem Szenario finden Sie unter Barrierefreiheit der Tastatur.
Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das KeyUp Eingabeereignis. Wenn ja, verfügt das Steuerelement wahrscheinlich über eine Außerkraftsetzung für die Methode "OnKeyUp". In der Regel sollen diese Klassenhandler eine Teilmenge von Tastendrücken verarbeiten, die eine tastaturbasierte Benutzerinteraktion mit diesem Steuerelement ermöglichen. Diese Interaktion unterstützt häufig ein Barrierefreiheitsfeature für die Tastatur. Wenn ein Tastaturtastenereignis durch eine klassenbasierte Behandlung behandelt wird, wird das Schlüsselereignis als bereits behandelt betrachtet, und das KeyUp-Ereignis wird nicht für die Behandlung durch Benutzercodehandler für dieses Steuerelement ausgelöst. In der Regel gilt dies nur für einige dedizierte Schlüssel.
Beispielsweise verfügt ButtonBase über eine Klassenbehandlung, sodass die LEERTASTE und die EINGABETASTE als Tastaturentsprechungen zum Aufrufen der Schaltfläche behandelt werden. Dies bietet eine integrierte Tastaturentsprechung zum Tippen auf die Schaltfläche oder zum Klicken mit einer Maus und ermöglicht das Barrierefreiheitsszenario der Verwendung der Benutzeroberfläche und der Schaltfläche nur mit einer Tastatur. Andere Schlüssel als Leerzeichen oder EINGABETASTE werden jedoch weiterhin für ein ButtonKeyDown- und KeyUp-Ereignis ausgelöst. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie in der Übersicht über Ereignisse und Routingereignisse.
KeyUp unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als handled gekennzeichnet sind. Siehe "AddHandler".