OnMouseDown Méthode (MouseButtonEventArgs)
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

UIElement.OnMouseDown, méthode (MouseButtonEventArgs)

 

Appelé lorsqu'un événement attaché Mouse.MouseDown non géré atteint un élément sur son itinéraire dérivé de cette classe.Implémentez cette méthode pour permettre la gestion de classes pour cet événement.

Espace de noms:   System.Windows
Assembly:  PresentationCore (dans PresentationCore.dll)

protected virtual void OnMouseDown(
	MouseButtonEventArgs e
)

Paramètres

e
Type: System.Windows.Input.MouseButtonEventArgs

MouseButtonEventArgs qui contient les données d'événement.Ces données d'événement signalent les détails portant sur le bouton de la souris ayant été appuyé et l'état de gestion.

Les actions de bouton de souris sont également gérées par un gestionnaire d'entrée dédié.Les autres fonctionnalités de programmation s'appuyant sur des actions de bouton, telles que les liaisons d'entrée et de commandes, peuvent appeler des gestionnaires pour l'action avant qu'elle ne soit exposée comme action générale de bouton de souris.Si ces fonctionnalités du système d'entrée marquent l'événement Mouse.MouseDown comme géré, OnMouseDown n'est alors pas appelé.

Si vous utilisez ce gestionnaire de classe pour marquer l'événement comme géré, vous risquez d'influer sur les événements MouseLeftButtonDown et MouseRightButtonDown.L'un de ces deux événements peut être déclenché sur l'élément cible lorsque Mouse.MouseDown est reçu.

Si vous marquez cet événement comme géré lors de la gestion de classe, les sous-événements sont toujours déclenchés, mais ils passent alors l'état de gestion à travers les données d'événement.Si l'événement est géré dans la gestion de classe, les gestionnaires d'instances pour les sous-événements ne sont pas appelés à moins que vous n'utilisiez explicitement AddHandler(RoutedEvent, Delegate, Boolean) avec handledEventsTootrue afin d'attacher les gestionnaires.Les gestionnaires de classe ne sont également pas appelés à moins que ces gestionnaires de classe aient été inscrits avec la signature RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean), avec handledEventsToo ayant la valeur true.En gérant OnMouseDown, vous indiquez de façon explicite que votre gestion de classe s'est chargée de toute action relative aux pressions de boutons de la souris.Ce comportement peut s'avérer indésirable ; attention par conséquent lorsque vous utilisez cette méthode virtuelle pour marquer des événements comme gérés.

Chacun des événements directs spécifiques aux boutons présente également une méthode virtuelle On* ; évaluez si la substitution de ces gestionnaires de classe spécifiques au bouton peut s'avérer plus appropriée.

Cette méthode ne dispose pas d'implémentation par défaut.Dans la mesure où une classe intermédiaire de l'héritage peut implémenter cette méthode, nous vous recommandons d'appeler l'implémentation de base dans votre implémentation.

Le but de cette méthode est semblable aux méthodes On* du schéma d'événement common language runtime (CLR) : cette méthode permet de gérer l'événement correspondant depuis des classes dérivées en établissant un gestionnaire de classe plutôt qu'un gestionnaire d'instance.Dans ce cas, l'événement correspondant est un événement routé.Le schéma d'implémentation des méthodes On* est différent pour les événements routés car un événement de ce type peut être déclenché par un élément enfant, qui n'est pas nécessairement l'élément chargé d'appeler les gestionnaires.Par conséquent, votre implémentation doit examiner les propriétés sources des données d'événement.Dans la plupart des cas, elle ne doit pas tenter de redéclencher l'événement.

Que ce soit en substituant cette méthode ou en inscrivant des gestionnaires de classe à l'aide de RegisterClassHandler, les classes dérivées de UIElement peuvent appeler des méthodes du gestionnaire de classes privées lorsque l'événement est reçu sur son itinéraire.Un scénario dans lequel la gestion de classe est particulièrement appropriée est la manipulation des données d'événement et le marquage de l'événement routé comme géré.

.NET Framework
Disponible depuis 3.0
Retour au début
Afficher:
© 2016 Microsoft