Compartir a través de


UIElement.PreviewMouseLeftButtonDown Evento

Definición

Se produce al presionar el botón primario del mouse mientras el puntero se encuentra sobre este elemento.

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

Tipo de evento

Implementaciones

Comentarios

Aunque este evento enrutado parece seguir una ruta de tunelización a través de un árbol de elementos, en realidad es un evento enrutado directo que se genera y se rerera a lo largo del árbol de elementos por cada UIElement.

Este evento es uno de varios eventos relacionados que notifican los detalles del botón del mouse de un evento subyacente Mouse.PreviewMouseDown , que es un evento adjunto que procesa cada elemento a lo largo de una ruta de eventos.

Los datos de evento de este evento exponen los datos del evento subyacente Mouse.PreviewMouseDown . Si ese evento se marca como controlado a lo largo de la ruta del evento, se siguen produciendo eventos específicos del botón del mouse; Sin embargo, los controladores de los eventos específicos del botón del mouse deben agregarse mediante una llamada explícita a AddHandler, con la opción de controlar los eventos que ya están marcados como controlados, con el fin de ser agentes de escucha para el evento. Si marca PreviewMouseLeftButtonDown el controlador, básicamente se marca Mouse.PreviewMouseDown para todos los agentes de escucha más a lo largo de la ruta y en todos los eventos relacionados. Esto posiblemente incluye eventos generados por el controlador de clases, como PreviewMouseDoubleClick.

Conceptualmente, piense en este evento (y otros eventos de botón del mouse en UIElement) para ser un "servicio" del mouse (con la definición de servicio proporcionada por la Mouse clase ). El evento agrega la comodidad de no necesitar comprobar los estados del botón del mouse (izquierda derecha, arriba hacia abajo) de los eventos originales del mouse en los datos del evento. Para escenarios más avanzados, como la comprobación de estados de botones no estándar, es posible que tenga que usar las API de la Mouse clase en lugar de las de UIElement.

Información sobre eventos enrutados

Campo identificador PreviewMouseLeftButtonDownEvent
Estrategia de enrutamiento Directo
Delegado MouseButtonEventHandler

Se aplica a

Consulte también