UIElement3D.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 cette vue d’ensemble des événements routés 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 UIElement3D.

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.MouseDown , 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.MouseDown . 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 MouseLeftButtonDown handled, vous marquez Mouse.MouseDown 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 MouseDoubleClick.

D’un point de vue conceptuel, considérez cet événement (et d’autres événements de bouton de souris sur UIElement3D) 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 UIElement3D.

Important

La gestion de classe marque souvent l’événement de classe sous-jacent Mouse comme géré. Une fois l’événement marqué comme géré, les autres gestionnaires de instance attachés à cet élément ne sont généralement pas déclenchés. Les autres gestionnaires de classe ou de instance qui sont attachés à des éléments dans la direction de la bulle vers la racine dans l’arborescence de l’interface utilisateur ne sont pas non plus généralement déclenchés.

Vous pouvez résoudre le problème décrit dans l’important précédent et toujours recevoir MouseLeftButtonDown des événements 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 :

  • Attachez 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 démarre à la racine et descend 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.

MouseLeftButtonDown est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

Informations sur les événements acheminés

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

S’applique à

Voir aussi