UIElement.KeyDown Événement

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

Se produit lorsqu’une touche de clavier est enfoncée alors que l’élément UIElement a le focus.

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

KeyEventHandler

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 système met le focus sur le premier élément de l’arborescence visuelle. Un élément individuel reçoit le focus lorsque l’utilisateur clique ou appuie directement sur cet élément dans l’interface ou qu’il utilise la touche Tab dans la zone de contenu. Vous pouvez également concentrer les contrôles par programmation en appelant Control.Focus.

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

KeyDown utilise les données d’événement KeyRoutedEventArgs . Les propriétés les plus significatives de KeyRoutedEventArgs pour la plupart des scénarios de gestionnaires sont Key et éventuellement KeyStatus. Pour plus d’informations sur la gestion des événements de clavier, notamment un exemple de code pour définir une méthode KeyEventHandler , consultez Interactions au clavier.

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

Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur les classes pour l’événement d’entrée KeyDown. Si c’est le cas, le contrôle a probablement une substitution pour la méthode OnKeyDown. En règle générale, ces gestionnaires de classes sont destinés à traiter un sous-ensemble d’appuis sur les 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é du clavier. Si une touche est gérée par la gestion basée sur les classes, l’appui sur la touche est considéré comme étant déjà géré, et l’événement KeyDown n’est pas déclenché pour la gestion par les gestionnaires de code utilisateur sur ce contrôle pour cette touche spécifiquement. En général, il s’agit uniquement de quelques clés dédiées. Par exemple, ButtonBase dispose d’une gestion des classes afin que la touche Espace et la touche Entrée soient gérées en tant qu’é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é d’utilisation de l’interface utilisateur et du bouton à l’aide d’un clavier uniquement. Mais toutes les autres touches autres que Espace ou Entrée déclenchent toujours un événement KeyDown et KeyUp pour un Bouton. Pour plus d’informations sur le fonctionnement de la gestion basée sur les classes des événements, consultez Vue d’ensemble des événements 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. Consultez AddHandler.

S’applique à

Voir aussi