Mouse.PreviewMouseDown Attached Event

Definition

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

see AddPreviewMouseDownHandler, and RemovePreviewMouseDownHandler
see AddPreviewMouseDownHandler, and RemovePreviewMouseDownHandler
see AddPreviewMouseDownHandler, and RemovePreviewMouseDownHandler

Remarks

Le bouton de la souris enfoncé est déterminé par la vérification des arguments de l’événement.Which mouse button was depressed is determined by checking the arguments of the event. Il s’agit d’un événement attaché (à l’aide de la stratégie de routage de tunneling) qui est prévu via la syntaxe d’événement attachée devant être référencée par les éléments de interface utilisateur (UI)user interface (UI) existants qui prennent une entrée.This is an attached event (using tunneling routing strategy) that is intended through attached event syntax to be referenced by existing interface utilisateur (UI)user interface (UI) elements that take input.

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. Les événements attachés sont fondamentalement un concept de langage XAMLXAML pour référencer des événements qui peuvent être gérés sur des objets qui ne définissent pas cet événement, sur lequel WPFWPF se développe en permettant également à l’événement de traverser 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. Les é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 du code, vous utilisez une méthode de gestionnaire Add * désignée.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 Framework Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) s’appuie sur cet événement attaché en le signalant comme deux événements de Common Language Runtime (CLR)common language runtime (CLR) différents sur UIElement: PreviewMouseLeftButtonDown et PreviewMouseRightButtonDown.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: PreviewMouseLeftButtonDown and PreviewMouseRightButtonDown. Ces implémentations gèrent l’événement PreviewMouseDown sous-jacent et lisent 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 PreviewMouseDown event and read the arguments of the event to determine whether the left or right mouse button was involved. Pour trois boutons, il n’existe aucune prise en charge des événements au niveau de l’infrastructure pour le bouton central, et vous devez utiliser l’événement PreviewMouseDown et vérifier la condition du bouton central dans les arguments de l’événement.For three-button, there is no framework-level event support for the center button, and you should use the PreviewMouseDown event and check for the center button condition in the event arguments.

Pour les événements routés liés à la souris, soyez prudent quant à la façon dont ou quand vous les marquez comme gérés.For routed events that relate to the mouse, be careful about how or when you mark them handled. La gestion de l’événement près de la racine et sa gestion par un enfant en plus de la source peuvent ne pas être appropriées pour les contrôles composites, où les éléments de composition peuvent avoir des comportements de souris attendus.Handling the event near the root and handling it by a child further toward the source may not be appropriate for composited controls, where the compositing pieces might have expected mouse behaviors. La difficulté de faire les choix appropriés quant à la nécessité de savoir si d’autres éléments doivent également être informés de l’action de la souris est en fait la raison pour laquelle le WPFWPF Framework a choisi le modèle d’affichage de l’événement routé Mouse sous-jacent en tant que CLRCLR événements sur l’itinéraire.The difficulty in making the appropriate choices about whether other 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.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field PreviewMouseDownEvent
Stratégie de routageRouting strategy TunnelingTunneling
DéléguerDelegate MouseButtonEventHandler
  • L’événement de propagation correspondant est MouseDown.The corresponding bubbling event is MouseDown.

Applies to