UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown Event

Définition

Se produit lorsque le bouton gauche de la souris est enfoncé alors que le pointeur est sur cet élément.Occurs when the left mouse button is pressed while the mouse pointer is over this element.

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 

Implémente

Remarques

Bien que cela événement routé semble suivre un itinéraire de propagation dans une arborescence d’éléments, il est en fait un événement routé direct qui est déclenché à plusieurs reprises dans l’arborescence d’éléments, chacun UIElement.Although this routed event seems to follow a bubbling route through an element tree, it actually is a direct routed event that is raised and reraised along the element tree by each UIElement.

Cet événement est une de plusieurs événements associés qui signalent les spécificités de bouton de la souris de sous-jacent Mouse.MouseDown événement, qui est un événement attaché est traité par chaque élément le long d’un itinéraire d’événement.This event is one of several related events that report the mouse-button specifics of an underlying Mouse.MouseDown event, which is an attached event that is processed by each element along an event route.

Les données d’événement de cet événement exposent les données d’événement de sous-jacent Mouse.MouseDown événement.The event data of this event exposes the event data of the underlying Mouse.MouseDown event. Si cet événement est marqué comme géré sur l’itinéraire d’événement, le bouton de la souris spécifiques sont toujours déclenchés ; Toutefois, les gestionnaires des événements spécifiques de bouton de la souris doivent être ajoutés en appelant explicitement AddHandler, avec l’option pour gérer les événements qui sont déjà marqués comme géré, afin d’être des écouteurs à l’événement.If that event is marked as handled along the event route, the mouse-button specific events are still raised; however, handlers of the mouse-button specific events must be added by explicitly calling AddHandler, with the option to handle events that are already marked as handled, in order to be listeners to the event. Si vous marquez MouseLeftButtonDown gérée, vous marquez essentiellement Mouse.MouseDown géré pour toutes les autres écouteurs sur l’itinéraire et tous les événements associés.If you mark MouseLeftButtonDown handled, you are essentially marking Mouse.MouseDown handled for all further listeners along the route, and on all related events. Cela peut inclure les événements du Gestionnaire de la classe générée comme MouseDoubleClick.This possibly includes class-handler generated events such as MouseDoubleClick.

Point de vue conceptuel, considérez cet événement (et d’autres événements de bouton de la souris sur UIElement) pour être une « service » de la souris (avec la définition du service fournie par le Mouse classe).Conceptually, think of this event (and other mouse-button events on UIElement) to be a mouse "service" (with the service definition provided by the Mouse class). L’événement ajoute la commodité ne pas nécessité de vérifier les États de bouton de la souris (gauche à droite, haut-bas) des événements de souris d’origine dans les données d’événement.The event adds the convenience of not needing to check the mouse button states (left-right, up-down) of the original mouse events in the event data. Pour des scénarios plus avancés, tels que la vérification des États de boutons non standard, vous devrez peut-être utiliser le APIAPIs sur le Mouse classe plutôt que ceux sur UIElement.For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the APIAPIs on the Mouse class rather than those on UIElement.

Important

Certaines classes de contrôle peuvent avoir inhérente gestion de classe pour les événements de bouton de la souris.Some control classes might have inherent class handling for mouse button events. La pression du bouton gauche de la souris est le plus probable pour que la gestion de classe dans un contrôle.The left mouse button down event is the most likely event to have class handling in a control. La gestion souvent de classe marque sous-jacent Mouse événement de classe comme étant géré.The class handling often marks the underlying Mouse class event as handled. Une fois que l’événement est marqué comme géré, les autres gestionnaires d’instance qui sont attachés à cet élément ne sont généralement pas déclenchés.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. N’importe quel autres instance ou la classe gestionnaires d’associés aux éléments dans la direction de propagation vers la racine dans l’arborescence de l’interface utilisateur sont également pas généralement déclenchés.Any other class or instance handlers that are attached to elements in the bubbling direction towards the root in the UI tree are also not ordinarily raised.

Vous pouvez résoudre le problème décrit dans l’Important précédent et recevez toujours MouseLeftButtonDown événements pour le bouton gauche de la souris vers le bas sur une classe dérivée qui a l’aide d’une de ces solutions de gestion de classe :You can resolve the issue that is outlined in the preceding Important and still receive MouseLeftButtonDown events for left mouse button down events on a derived class that has class handling by using either of these solutions:

  • Joindre des gestionnaires pour les PreviewMouseDown événement, qui n’est pas marqué comme géré par les contrôles.Attach handlers for the PreviewMouseDown event, which is not marked as handled by the controls. Notez que, comme il s’agit d’un événement d’aperçu, l’itinéraire démarre à la racine et tunnels au contrôle.Notice that because this is a preview event, the route starts at the root and tunnels down to the control.

  • Enregistrez un gestionnaire sur le contrôle en appelant AddHandler et en choisissant l’option de signature qui permet aux gestionnaires d’écouter des événements même s’ils sont déjà marqués comme gérés dans les données d’événement routé.Register a handler on the control procedurally by calling AddHandler and choosing the signature option that enables handlers to listen for events even if they are already marked as handled in the routed event data.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field MouseLeftButtonDownEvent
Stratégie de routageRouting strategy DirectDirect
déléguéDelegate MouseButtonEventHandler
  • Substituer OnMouseLeftButtonDown pour implémenter la gestion de classe pour cet événement dans les classes dérivées.Override OnMouseLeftButtonDown to implement class handling for this event in derived classes.

S’applique à

Voir aussi