UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Méthode

Définition

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:
 virtual void OnPreviewMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);
protected 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 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 un itinéraire 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 UIElement le long de l’itinéraire d’événement utilise la même gestion 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 étant 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 événements de souris dans UIElement écoute Mouse.PreviewMouseDown et le 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 classe pour Mouse.PreviewMouseDown. Vous ne pouvez pas modifier le comportement de gestion de la souris de UIElement en OnPreviewMouseLeftButtonDownremplaçant .

Vous pouvez également remplacer cette méthode afin de modifier la gestion des événements pour un état de souris spécifique. Le choix 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 .

S’applique à