Freigeben über


UIElement.KeyUp Ereignis

Definition

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

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 steht im Fokus, wenn Benutzer im Layout auf das Steuerelement klicken oder tippen oder mit der TAB-Taste im Inhaltsbereich eine Aktivierreihenfolge durchlaufen. Sie können Steuerelemente auch programmgesteuert fokussieren, indem Sie Control.Focus aufrufen.

KeyUp ist ein Routingereignis. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

KeyUp verwendet KeyRoutedEventArgs-Ereignisdaten . Die wichtigsten Eigenschaften von KeyRoutedEventArgs für die meisten Handler-Szenarien 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 KeyUp-Eingabeereignis. Wenn dies der Grund ist, verfügt das Steuerelement wahrscheinlich über eine Außerkraftsetzung für die OnKeyUp-Methode. In der Regel sind diese Klassenhandler für die Verarbeitung einer Teilmenge von Tastendrücken vorgesehen, die eine tastaturbasierte Benutzerinteraktion mit diesem Steuerelement ermöglichen, und häufig unterstützt diese Interaktion eine Tastaturzugriffsfunktion. Wenn ein Tastaturtastenereignis von der klassenbasierten Behandlung behandelt wird, gilt das Schlüsselereignis als bereits verarbeitet, und das KeyUp-Ereignis wird nicht für die Behandlung durch Benutzercodehandler für dieses Steuerelement 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 mit einer Tastatur verwendet werden. Aber alle anderen Schlüssel außer Leerzeichen oder EINGABETASTE lösen weiterhin ein KeyDown - und KeyUp-Ereignis für eine Schaltfläche aus. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung von Ereignissen finden Sie unter Ü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 Verarbeitet gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.

Gilt für:

Weitere Informationen