ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Méthode appelée quand un événement routé PreviewMouseLeftButtonDown 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 public:
 virtual void OnPreviewMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected internal virtual void OnPreviewMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Friend Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

Paramètres

e

MouseButtonEventArgs

MouseButtonEventArgs qui contient les données d'événement. Les données d’événement signalent que le bouton gauche de la souris a été enfoncé.

Remarques

L’événement PreviewMouseLeftButtonDown semble parcourir une route de tunnel mais se déplace en fait de manière indirecte. Mouse.PreviewMouseDown est l’événement sous-jacent routé par tunnel, et chacun ContentElement le long de l’itinéraire d’événements utilise une gestion identique pour déclencher l’événement PreviewMouseLeftButtonDownrouté direct . Bien que vous puissiez marquer l’événement PreviewMouseLeftButtonDown comme étant géré pour les besoins de cet élément, l’état géré ne se perpétue pas à d’autres éléments le long de l’itinéraire de l’événement. Toutefois, vous pouvez marquer l’événement comme géré afin d’empêcher l’appel de gestionnaires de instance généraux (ceux qui n’ont pas spécifié handledEventsToo).

L’implémentation par défaut pour la gestion générale des Mouse.PreviewMouseDown événements de souris dans ContentElement écoute et la convertit en événement local approprié. Si vous souhaitez remplacer cette logique, vous devez créer une classe dérivée. Dans le constructeur statique de votre classe dérivée, inscrivez un autre gestionnaire de classes pour Mouse.PreviewMouseDown. Vous ne pouvez pas modifier le comportement de gestion de la souris de ContentElement en OnPreviewMouseLeftButtonDownremplaçant .

Vous pouvez également remplacer cette méthode afin de modifier la gestion des événements pour un état spécifique de la souris. Le choix ou non d’appeler l’implémentation de base dépend de votre scénario. L’échec de l’appel de base désactive la gestion des entrées par défaut pour cet événement de souris sur les classes ancêtres qui s’attendent également à appeler OnPreviewMouseLeftButtonDown. Par exemple, vous pouvez dériver de Button et remplacer OnPreviewMouseLeftButtonDown dans votre classe dérivée sans appeler l’implémentation de base ; toutefois, cette substitution désactive l’événement Click .