Langage

UIElement.KeyUp Événement

Définition

Se produit lorsqu’une touche de clavier est libérée pendant que l’uiElement a le focus.

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"/>

Type d’événement

Remarques

Les contrôles de votre interface utilisateur génèrent des événements de clavier uniquement lorsqu’ils ont le focus d’entrée. Par défaut, le premier élément pouvant être focusé dans l’arborescence visuelle est mis au focus par le système. Un contrôle individuel reçoit le focus lorsque l’utilisateur clique ou tape directement sur ce contrôle dans la mise en page, ou lorsqu’il utilise la touche Tab pour accéder à une séquence de tabulation dans la zone de contenu. Vous pouvez également concentrer les contrôles par programmation en appelant UIElement.Focus(Microsoft. UI. Xaml.FocusState).

KeyUp est un événement routé. Pour plus d’informations sur le concept d’événement routé, consultez la vue d’ensemble des événements routés et des événements routés.

KeyUp utilise les données d’événement KeyRoutedEventArgs . Les propriétés les plus pertinentes de la plupart des KeyRoutedEventArgs scénarios de gestionnaire sont Key et éventuellement KeyStatus. Pour plus d’informations sur la gestion des événements clavier, notamment l’exemple de code permettant de définir une méthode KeyEventHandler , consultez interactions clavier.

L’un des scénarios de gestion des événements clavier consiste à prendre en charge les touches d’accès ou les touches d’accélérateur d’une application, ou une région ou un contrôle au sein d’une application. Pour plus d’informations sur ce scénario, consultez l’accessibilité du clavier.

Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur des classes pour l’événement d’entréeKeyUp. Dans ce cas, le contrôle a probablement un remplacement pour la méthode OnKeyUp. En règle générale, ces gestionnaires de classes sont destinés à traiter un sous-ensemble d’appuis de touches qui permettent une interaction utilisateur basée sur le clavier avec ce contrôle, et souvent cette interaction prend en charge une fonctionnalité d’accessibilité au clavier. Si un événement de touche clavier est géré par la gestion basée sur la classe, l’événement de clé est considéré comme déjà géré et l’événement KeyUp n’est pas déclenché pour la gestion par les gestionnaires de code utilisateur sur ce contrôle. En règle générale, il s’agit simplement de quelques clés dédiées. Par exemple, ButtonBase dispose d’une gestion de classe pour que la touche Espace et la touche Entrée soient gérées comme équivalents clavier pour appeler le bouton. Cela fournit un clavier intégré équivalent pour appuyer sur le bouton ou cliquer dessus avec une souris, et active le scénario d’accessibilité de l’utilisation de l’interface utilisateur et du bouton à l’aide d’un clavier uniquement. Mais toutes les autres clés autres que l’espace ou Entrée déclenchent toujours un événement KeyDown et KeyUp pour un Button. Pour plus d’informations sur le fonctionnement de la gestion basée sur des classes pour les événements, consultez La vue d’ensemble des événements routés et des événements routés.

KeyUp prend en charge la possibilité d’attacher des gestionnaires d’événements à l’itinéraire qui sera appelé même si les données d’événement de l’événement sont marquées Handled. Voir AddHandler.

S’applique à

Voir aussi