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 le Mouse.MouseDown joint des événements pour cette classe, afin que MouseDown fait partie de la classe liste des membres lorsque ContentElement est hérité comme é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. Gestionnaires d’événements qui sont attachés à la MouseDown événements sont attachés à sous-jacent Mouse.MouseDown événement attaché 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.

Le MouseDown événement est déclenché souvent avec MouseLeftButtonDown ou MouseRightButtonDown, qui correspondent à une action sur l’un des deux boutons de 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. MouseLeftButtonDown et MouseRightButtonDown sont également des événements routés, mais ils sont les événements routés directs, et l’événement spécifique au bouton approprié est déclenché lorsque le Mouse.MouseDown é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 Notes pour MouseLeftButtonDown ou MouseRightButtonDown.See Remarks for MouseLeftButtonDown or MouseRightButtonDown.

Important

Quelques ContentElement dérivées des classes qui ont le comportement de type contrôle, par exemple, Hyperlink, peut-être inhérente gestion de classe pour les événements de bouton de la souris.A few ContentElement derived classes that have control-like behavior, for example, Hyperlink, 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 MouseDown é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 MouseDown 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 MouseDownEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate MouseButtonEventHandler
  • L’événement de tunneling correspondant est PreviewMouseDown.The corresponding tunneling event is PreviewMouseDown.

  • Substituer 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 à