Mouse.MouseDown Mouse.MouseDown Mouse.MouseDown Attached Event

Définition

Se produit lorsqu'un bouton de la souris est enfoncé.Occurs when any mouse button is depressed.

see AddMouseDownHandler, and RemoveMouseDownHandler
see AddMouseDownHandler, and RemoveMouseDownHandler
see AddMouseDownHandler, and RemoveMouseDownHandler

Remarques

Pour déterminer quel bouton de la souris a été enfoncé, vérifiez le ChangedButton propriété dans le MouseButtonEventArgs passé au gestionnaire.To determine which mouse button was depressed, check the ChangedButton property in the MouseButtonEventArgs passed to the handler.

Il s’agit d’un événement attaché.This is an attached event. WPFWPF implémente les événements attachés en tant qu’événements routés.implements attached events as routed events. Événements attachés sont fondamentalement un XAMLXAML concept de langage pour faire référence à des événements qui peuvent être gérés sur des objets qui ne définissent pas cet événement, ce qui WPFWPF étend en permettant également l’événement à parcourir un itinéraire.Attached events are fundamentally a XAMLXAML language concept for referencing events that can be handled on objects that do not define that event, which WPFWPF expands upon by also enabling the event to traverse a route. Événements attachés n’ont pas de syntaxe de gestion directe dans le code ; Pour attacher des gestionnaires pour un événement routé dans le code, vous utilisez un ajouter désigné * méthode de gestionnaire.Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. Pour plus d’informations, consultez vue d’ensemble des événements attachés.For details, see Attached Events Overview.

Le Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) framework s’appuie sur cet événement attaché signale comme deux Common Language Runtime (CLR)common language runtime (CLR) événements sur UIElement et ContentElement: MouseLeftButtonDown et MouseRightButtonDown.The Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) framework builds on this attached event by surfacing it as two different Common Language Runtime (CLR)common language runtime (CLR) events on UIElement and ContentElement: MouseLeftButtonDown and MouseRightButtonDown. Ces implémentations gèrent sous-jacent MouseDown événement et lire les arguments de l’événement pour déterminer si le bouton gauche ou droit de la souris a été impliqué.These implementations handle the underlying MouseDown event and read the arguments of the event to determine whether the left or right mouse button was involved. Pour une souris à trois boutons, il n’existe aucune prise en charge des événements au niveau du framework pour le bouton central.For a three-button mouse, there is no framework-level event support for the center button. Vous devez utiliser le MouseDown événement et vérifiez la MiddleButton arguments de l’événement d’état.You should use the MouseDown event and check the MiddleButton state in the event arguments.

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 la Remarque importante précédente 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 note 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.

Pour les événements routés qui se rapportent à la souris, veillez à comment ou quand vous les marquer comme gérés.For routed events that relate to the mouse, be careful about how or when you mark them handled. La difficulté de faire les choix appropriés si éléments parents doivent également être informés chaque action de la souris en fait, pourquoi le WPFWPF framework a choisi le l’événement de souris routée sous-jacent être exposés en tant que CLRCLR événements le long de l’itinéraire.The difficulty in making the appropriate choices about whether parent elements should also be informed about any given mouse action is in fact why the WPFWPF framework chose the model of having the underlying mouse routed event be surfaced as CLRCLR events along the route. Il existe des problèmes similaires avec le tunneling des événements de souris.Similar issues exist with tunneling mouse events. Doit gérer l’événement et ne pas être gérée par les autres enfants en direction de la source, et quel serait l’impact sur composition un contrôle dont les éléments peuvent attendre des comportements de souris ?Should you handle the event and not have it be handled by further children toward the source, and how would that affect compositing a control where the compositing pieces might have expected mouse behaviors?

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

S’applique à