UIElement.KeyDown Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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 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 accéder à 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 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 pertinentes de pour la plupart des scénarios de KeyRoutedEventArgs gestionnaire 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 l’interaction utilisateur basée sur le clavier avec ce contrôle. 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 règle générale, 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é de l’utilisation de l’interface utilisateur et du bouton à l’aide d’un clavier uniquement. Mais toutes les autres clés autres que Space ou Enter 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 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.