ContentElement.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.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 

Type d'événement

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 long de l’arborescence d’éléments par chaque ContentElement .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 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.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 l’événement sous-jacent Mouse.MouseDown .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 explicitement AddHandler , 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 événements de bouton de la souris sur ContentElement ) comme étant un « service » de la souris (avec la définition de service fournie par la Mouse 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 vérification des États de boutons non standard, vous devrez peut-être utiliser les API sur la Mouse classe plutôt que celles sur ContentElement .For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the APIs 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 exemple, Hyperlink , 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’événement de classe sous-jacent Mouse 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 des MouseLeftButtonDown é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 l' 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 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 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é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