ContentElement.OnKeyDown(KeyEventArgs) ContentElement.OnKeyDown(KeyEventArgs) ContentElement.OnKeyDown(KeyEventArgs) ContentElement.OnKeyDown(KeyEventArgs) Method

Définition

Appelée quand un événement joint KeyDown non géré atteint un élément de son itinéraire qui est dérivé de cette classe.Invoked when an unhandled KeyDown attached event reaches an element in its route that is derived from this class. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.Implement this method to add class handling for this event.

protected public:
 virtual void OnKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected internal virtual void OnKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Friend Overridable Sub OnKeyDown (e As KeyEventArgs)

Paramètres

e
KeyEventArgs KeyEventArgs KeyEventArgs KeyEventArgs

KeyEventArgs qui contient les données d'événement.The KeyEventArgs that contains the event data.

Remarques

Les séquences de touches sont gérées par un gestionnaire d’entrée dédié.Keystrokes are handled by a dedicated input manager. D’autres fonctionnalités de programmation qui reposent sur les séquences de touches, par exemple les liaisons d’entrée et de commande, peuvent gérer la séquence de touches avant qu’elle ne soit exposée en tant que séquence de touches générale.Other programming features that rely on keystrokes, for example, input and command bindings, might handle the keystroke before it is exposed as a general keystroke. Si ces fonctionnalités de système d’entrée marquent l’événement comme OnKeyDown étant géré, n’est pas appelé.If these input system features mark the event as handled, then OnKeyDown is not invoked.

Cette méthode n’a pas d’implémentation par défaut.This method has no default implementation. Étant donné qu’une classe intermédiaire dans l’héritage peut implémenter cette méthode, nous vous recommandons d’appeler l’implémentation de base dans votre implémentation de.Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

L’objectif de cette méthode est similaire au modèle Common Language Runtime (CLR)common language runtime (CLR) d’événement sur* les méthodes: cette méthode fournit les moyens de gérer l’événement correspondant à partir des classes dérivées en établissant un gestionnaire de classe au lieu d’un gestionnaire d’instance.The purpose of this method is similar to the Common Language Runtime (CLR)common language runtime (CLR) event pattern On* methods: this method provides the means to handle the matching event from derived classes by establishing a class handler instead of an instance handler. Dans ce cas, l’événement correspondant est un événement routé.In this case the matching event is a routed event. Le modèle d’implémentation des méthodes* on est différent pour les événements routés, car un événement routé peut être déclenché par un élément enfant, qui n’est pas nécessairement l’élément qui appellera des gestionnaires.The implementation pattern of the On* methods is different for routed events because a routed event can be raised by a child element, which is not necessarily the element that will invoke handlers. Par conséquent, votre implémentation doit examiner les propriétés sources des données d’événement.Therefore, your implementation needs to examine the source properties of the event data. Dans la plupart des cas, il ne doit pas essayer de déclencher à nouvel événement.It should not try to reraise the event in most cases.

Soit en substituant cette méthode, soit en inscrivant des gestionnaires RegisterClassHandlerde classe avec, ContentElement les classes dérivées de peuvent appeler des méthodes de gestionnaire de classes privées lorsque l’événement est reçu le long de l’itinéraire d’événement.Either by overriding this method or by registering class handlers with RegisterClassHandler, derived classes of ContentElement can call private class handler methods when the event is received along the event route. Un scénario dans lequel la gestion de classe est appropriée consiste à manipuler les données d’événement et à marquer l’événement routé comme géré.One scenario where class handling is appropriate is to manipulate the event data and mark the routed event as handled.

S’applique à

Voir aussi