Partage via


UIElement.MouseLeftButtonDown É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 ^ MouseLeftButtonDown;
public event System.Windows.Input.MouseButtonEventHandler MouseLeftButtonDown;
member this.MouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event MouseLeftButtonDown As MouseButtonEventHandler 

Type d'événement

Implémente

Remarques

Bien que cet événement routé semble suivre un itinéraire bouillonnant à 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 associés qui signalent les spécificités du bouton de la souris d’un événement sous-jacent Mouse.MouseDown , qui est un événement attaché qui est traité par chaque élément le long d’un itinéraire d’événements.

Les données d’événement de cet événement exposent les données d’événement de l’événement sous-jacent Mouse.MouseDown . Si cet événement est marqué comme géré le long de l’itinéraire des événements, 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 MouseLeftButtonDown géré, vous marquez Mouse.MouseDown essentiellement géré 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 MouseDoubleClick.

Conceptuellement, 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-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 recherche d’états de boutons non standard, vous devrez peut-être utiliser les API sur la Mouse classe plutôt que sur UIElement.

Important

Certaines classes de contrôle peuvent avoir une gestion de classe inhérente pour les événements de bouton de souris. L’événement de bas du bouton gauche de la souris est l’événement le plus susceptible d’avoir une gestion de classe dans un contrôle. La gestion de classe marque souvent l’événement de classe sous-jacent Mouse comme géré. Une fois que l’événement est marqué comme étant géré, d’autres gestionnaires instance qui sont attachés à cet élément ne sont pas normalement déclenchés. Tous les autres gestionnaires de classes ou de instance qui sont attachés à des éléments dans le sens bouillonnant vers la racine dans l’arborescence de l’interface utilisateur ne sont pas normalement déclenchés.

Vous pouvez résoudre le problème décrit dans les événements Importants précédents et toujours recevoir MouseLeftButtonDown pour les événements du bouton gauche de la souris sur une classe dérivée qui a une gestion de classe à l’aide de l’une des solutions suivantes :

  • Attacher des gestionnaires pour l’événement PreviewMouseDown , qui n’est pas marqué comme géré par les contrôles. Notez qu’étant donné qu’il s’agit d’un événement en préversion, l’itinéraire commence à la racine et passe jusqu’au contrôle.

  • Inscrivez un gestionnaire sur le contrôle de manière procédurale en appelant AddHandler et en choisissant l’option de signature qui permet aux gestionnaires d’écouter les événements même s’ils sont déjà marqués comme gérés dans les données d’événement routées.

Informations sur les événements acheminés

Champ Identificateur MouseLeftButtonDownEvent
Stratégie de routage Direct
Délégué MouseButtonEventHandler
  • Remplacez OnMouseLeftButtonDown pour implémenter la gestion des classes pour cet événement dans des classes dérivées.

S’applique à

Voir aussi