UIElement.PreviewMouseLeftButtonDown Événement

Définition

Se produit lorsque le bouton gauche de la souris est enfoncé alors que le pointeur est sur cet élément.

public:
 virtual event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseLeftButtonDown;
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseLeftButtonDown;
member this.PreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event PreviewMouseLeftButtonDown As MouseButtonEventHandler 

Type d'événement

Implémente

Remarques

Bien que cet événement routé semble suivre un itinéraire de tunneling à travers une arborescence d’éléments, il s’agit en fait d’un événement routé direct qui est déclenché et réévalué le long de l’arborescence d’éléments par chaque UIElement.

Cet événement est l’un des événements connexes qui signalent les spécificités du bouton de la souris d’un événement sous-jacent Mouse.PreviewMouseDown , qui est un événement attaché qui est traité par chaque élément le long d’un itinéraire d’événement.

Les données d’événement de cet événement exposent les données d’événement de l’événement sous-jacent Mouse.PreviewMouseDown . Si cet événement est marqué comme géré le long de l’itinéraire de l’événement, les événements spécifiques au bouton de la souris sont toujours déclenchés ; Toutefois, les gestionnaires des événements spécifiques au bouton de la souris doivent être ajoutés en appelant AddHandlerexplicitement , avec la possibilité de gérer les événements qui sont déjà marqués comme gérés, afin d’être des écouteurs de l’événement. Si vous marquez PreviewMouseLeftButtonDown handled, vous marquez Mouse.PreviewMouseDown essentiellement handled pour tous les autres écouteurs le long de l’itinéraire et sur tous les événements associés. Cela inclut peut-être des événements générés par le gestionnaire de classes, tels que PreviewMouseDoubleClick.

D’un point de vue conceptuel, considérez cet événement (et d’autres événements de bouton de souris sur UIElement) comme un « service » de souris (avec la définition de service fournie par la Mouse classe ). L’événement ajoute la commodité de ne pas avoir à case activée les états du bouton de la souris (gauche-droite, haut vers le bas) des événements de souris d’origine dans les données d’événement. Pour les scénarios plus avancés, tels que la vérification de l’état des boutons non standard, vous devrez peut-être utiliser les API sur la Mouse classe plutôt que sur UIElement.

Informations sur les événements acheminés

Champ Identificateur PreviewMouseLeftButtonDownEvent
Stratégie de routage Direct
Délégué MouseButtonEventHandler

S’applique à

Voir aussi