UIElement.KeyDown Événement

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

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 obtient le focus lorsque l’utilisateur clique ou appuie directement sur ce contrôle dans la disposition ou utilise la touche Tab pour passer à une séquence d’onglets dans la zone de contenu. Vous pouvez également concentrer les contrôles par programmation en appelant UIElement.Focus(Microsoft. UI. Xaml.FocusState).

KeyDown 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.

KeyDown 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ée KeyDown. Dans ce cas, le contrôle a probablement un remplacement pour la méthode OnKeyDown. En règle générale, ces gestionnaires de classes sont destinés à traiter un sous-ensemble d’appuis de touches qui permettent l’interaction utilisateur basée sur le clavier avec ce contrôle. Souvent, cette interaction prend en charge une fonctionnalité d’accessibilité au clavier. Si une touche est gérée par la gestion basée sur des classes, la touche est considérée comme déjà gérée et l’événement KeyDown n’est pas déclenché pour la gestion par les gestionnaires de code utilisateur sur ce contrôle spécifiquement. 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.

KeyDown 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.

Voir aussi

• KeyRoutedEventArgs
• KeyUp
• GotFocus
• OnKeyDown(KeyRoutedEventArgs)
• Interactions avec le clavier
• Vue d’ensemble des événements et des événements routés
• Exemple d’événements d’entrée utilisateur XAML