UIElement.OnMouseLeftButtonDown(MouseButtonEventArgs) Méthode

Définition

Méthode appelée quand un événement routé MouseLeftButtonDown non géré est déclenché sur cet élément. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.

protected:
 virtual void OnMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);
protected virtual void OnMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);
abstract member OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
Protected Overridable Sub OnMouseLeftButtonDown (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 MouseLeftButtonDown semble parcourir une route bouillonnante, mais se déplace en fait de manière indirecte. Mouse.MouseDown est l’événement sous-jacent routé par bulles, et chacun UIElement le long de l’itinéraire d’événements utilise une gestion identique pour déclencher l’événement MouseLeftButtonDownrouté direct . Bien que vous puissiez marquer l’événement MouseLeftButtonDown 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.MouseDown événements de souris dans UIElement é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.MouseDown. Vous ne pouvez pas modifier le comportement de gestion de la souris de UIElement en OnMouseLeftButtonDownremplaç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 OnMouseLeftButtonDown. Par exemple, vous pouvez dériver de Button et remplacer OnMouseLeftButtonDown dans votre classe dérivée sans appeler l’implémentation de base ; toutefois, cette substitution désactive l’événement Click .

S’applique à