ContentElement.MouseLeftButtonDown ContentElement.MouseLeftButtonDown ContentElement.MouseLeftButtonDown ContentElement.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 cette vue d’ensemble des événements routés semble suivre un itinéraire de propagation dans une arborescence d’éléments, il s’agit en fait d’un événement routé direct qui est déclenché et redéclenché le ContentElementlong de l’arborescence d’éléments par chaque.Although this Routed Events Overview 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 ContentElement.

Cet événement est l’un des nombreux événements connexes qui signalent les caractéristiques de bouton de la souris Mouse.MouseDown d’un événement sous-jacent, qui est un événement attaché qui 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 arguments de cet événement exposent les arguments de Mouse.MouseDown l’événement sous-jacent.The arguments of this event expose the arguments of the underlying Mouse.MouseDown event. Si cet événement est marqué comme géré le long de l’itinéraire d’événement, les événements spécifiques aux boutons de la souris sont toujours déclenchés; Toutefois, les gestionnaires des événements spécifiques aux boutons de la souris doivent être ajoutés en appelant AddHandlerexplicitement, avec l’option pour gérer les événements qui sont déjà marqués comme gérés, afin d’être des écouteurs de 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.

D’un point de vue conceptuel, considérez cet événement (et les autres ContentElementévénements de bouton de la souris sur) comme étant un «service» de la Mouse souris (avec la définition de service fournie par la classe).Conceptually, think of this event (and other mouse-button events on ContentElement) to be a mouse "service" (with the service definition provided by the Mouse class). L’événement permet de ne pas avoir à vérifier les États des boutons de la souris (de gauche à droite et de haut en haut) 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 APIAPIs vérification des États de boutons non standard, vous devrez peut-être utiliser sur la Mouse classe plutôt que sur ContentElement.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 ContentElement.

Important

Quelques ContentElement classes dérivées qui ont un comportement de type contrôle, par Hyperlinkexemple,, peuvent avoir une gestion de classe inhérente pour les événements de bouton de souris.A few ContentElement derived classes that have control-like behavior, for example, Hyperlink, might have inherent class handling for mouse button events. Le bouton gauche de la souris enfoncé est l’événement le plus probable pour 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 de classe marque souvent l' Mouse événement de classe sous-jacent comme 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 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. Les autres gestionnaires de classes ou d’instances attachés à des éléments dans la direction de propagation vers la racine dans l’arborescence de l’interface utilisateur ne sont pas non plus 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’élément important précédent tout en recevant MouseLeftButtonDown des événements pour le bouton gauche de la souris enfoncé sur une classe dérivée qui a une gestion de classe à l’aide de l’une de ces solutions: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:

  • Attachez des gestionnaires pour PreviewMouseDown l’é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 qu’étant donné qu’il s’agit d’un événement d’aperçu, l’itinéraire commence à la racine et passe au contrôle.Notice that because this is a preview event, the route starts at the root and tunnels down to the control.

  • Inscrivez un gestionnaire sur le contrôle de manière procédurale AddHandler en appelant 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és.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
  • Substituez 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