ContentElement.MouseDown ContentElement.MouseDown ContentElement.MouseDown ContentElement.MouseDown Event

Définition

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

public:
 event System::Windows::Input::MouseButtonEventHandler ^ MouseDown;
public event System.Windows.Input.MouseButtonEventHandler MouseDown;
member this.MouseDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event MouseDown As MouseButtonEventHandler 

Remarques

Cet événement crée un alias pour l' Mouse.MouseDown événement attaché pour cette classe, afin qu' MouseDown il fasse partie de la liste des membres ContentElement de la classe lorsque est hérité en tant qu’élément de base.This event creates an alias for the Mouse.MouseDown attached event for this class, so that MouseDown is part of the class members list when ContentElement is inherited as a base element. Les gestionnaires d’événements attachés à l' MouseDown événement sont attachés à l' Mouse.MouseDown événement attaché sous-jacent et reçoivent la même instance de données d’événement.Event handlers that are attached to the MouseDown event are attached to the underlying Mouse.MouseDown attached event and receive the same event data instance.

L' MouseDown événement est souvent déclenché MouseLeftButtonDown avec ou MouseRightButtonDown, ce qui correspond à une pression sur l’un des deux boutons de la souris standard.The MouseDown event is often raised together with either MouseLeftButtonDown or MouseRightButtonDown, which correspond to a press of one of the two standard mouse buttons. MouseLeftButtonDownet MouseRightButtonDown sont également des événements routés, mais il s’agit d’événements routés directs, et l’événement spécifique au bouton approprié est Mouse.MouseDown déclenché lorsque l’événement atteint cet élément le long de l’itinéraire d’événement.MouseLeftButtonDown and MouseRightButtonDown are also routed events, but they are direct routed events, and the appropriate button-specific event is raised when the Mouse.MouseDown event reaches this element along the event route. Consultez la section MouseLeftButtonDown notes MouseRightButtonDownpour ou.See Remarks for MouseLeftButtonDown or MouseRightButtonDown.

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 MouseDown 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 MouseDown 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 MouseDownEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate MouseButtonEventHandler
  • L’événement de tunneling correspondant PreviewMouseDownest.The corresponding tunneling event is PreviewMouseDown.

  • Substituez OnMouseDown pour implémenter la gestion de classe pour cet événement dans les classes dérivées.Override OnMouseDown to implement class handling for this event in derived classes.

S’applique à