UIElement.OnPreviewKeyDown(KeyEventArgs) Méthode
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.
Méthode appelée lorsqu'un événement attaché PreviewKeyDown non géré atteint un élément de son itinéraire qui est dérivé de cette classe. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.
protected:
virtual void OnPreviewKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected virtual void OnPreviewKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Overridable Sub OnPreviewKeyDown (e As KeyEventArgs)
Paramètres
KeyEventArgs qui contient les données d'événement.
Remarques
Cette méthode n’a pas d’implémentation par défaut. É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.
L’objectif de cette méthode est similaire au modèle d’événement CLR (Common Language Runtime) On* : cette méthode fournit les moyens de gérer l’événement de correspondance à partir de classes dérivées en établissant un gestionnaire de classes au lieu d’un gestionnaire de instance. Dans ce cas, l’événement correspondant est un événement routé. 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. Par conséquent, votre implémentation doit examiner les propriétés sources des données d’événement. Il ne doit pas essayer de réévaluer l’événement dans la plupart des cas.
En substituant cette méthode ou en inscrivant des gestionnaires de classes auprès RegisterClassHandlerde , les classes dérivées de peuvent appeler des méthodes de gestionnaire de UIElement classes privées lorsque l’événement est reçu le long de l’itinéraire des événements. L’un des scénarios où la gestion des classes est appropriée consiste à manipuler les données d’événement et à marquer l’événement routé comme étant géré. Un autre scénario spécifique aux événements en préversion consiste à les marquer gérés afin que les gestionnaires de classes bouillonnants correspondants ne soient pas appelés.