FlowDocumentReader.OnKeyDown(KeyEventArgs) Méthode

Définition

Appelée chaque fois qu'un événement routé attaché KeyDown non géré rencontre un élément dérivé de cette classe sur son itinéraire. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.

protected:
 override void OnKeyDown(System::Windows::Input::KeyEventArgs ^ e);
[System.Security.SecurityCritical]
[System.Security.SecurityTreatAsSafe]
protected override void OnKeyDown (System.Windows.Input.KeyEventArgs e);
protected override void OnKeyDown (System.Windows.Input.KeyEventArgs e);
[<System.Security.SecurityCritical>]
[<System.Security.SecurityTreatAsSafe>]
override this.OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Overrides Sub OnKeyDown (e As KeyEventArgs)

Paramètres

e
KeyEventArgs

Fournit des données sur l'événement.

Attributs

Remarques

Les séquences de touches sont gérées par un gestionnaire d’entrées dédié. D’autres fonctionnalités de programmation qui s’appuient sur des séquences de touches, telles que les liaisons d’entrée et de commande, gèrent potentiellement la séquence de touches avant qu’elle ne soit exposée en tant que séquence de touches générale. Si ces fonctionnalités du système d’entrée marquent l’événement géré, elles OnKeyDown ne sont pas appelées.

Cette méthode n’a pas d’implémentation par défaut. L’appel de base() dans votre implémentation est toujours recommandé, au cas où une classe intermédiaire dans l’héritage implémentait cette méthode. Vous pouvez appeler base() avant ou après votre gestion spéciale, en fonction de vos besoins.

L’objectif de cette méthode est un peu similaire aux méthodes On* du modèle d’événement du Common Language Runtime (CLR) : elle fournit les moyens de gérer l’événement correspondant à partir de classes dérivées avec 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 l’événement routé peut avoir été déclenché par un élément enfant, pas nécessairement l’élément qui appellera des gestionnaires. Votre implémentation devra donc prendre en compte les propriétés sources des arguments d’événement (et ne doit pas essayer de relancer l’événement dans la plupart des cas). Les sous-classes de peuvent choisir d’appeler des méthodes de gestionnaire de classes privées lorsque l’événement est reçu le long de FlowDocumentReader l’itinéraire. Un scénario potentiel consiste à prendre les arguments de l’événement et à marquer l’événement comme étant géré.

S’applique à

Voir aussi