UIElement3D.PreviewMouseLeftButtonDown Evento

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

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

MouseButtonEventHandler

Implementaciones

PreviewMouseLeftButtonDown

Comentarios

Aunque esta información general de eventos enrutados 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 UIElement3D.

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 UIElement3D) 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 UIElement3D.

PreviewMouseLeftButtonDown se introduce en .NET Framework versión 3.5. Para más información, vea Versiones y dependencias.

Información sobre eventos enrutados

Campo identificador	PreviewMouseLeftButtonDownEvent
Estrategia de enrutamiento	Directo
Delegado	MouseButtonEventHandler

• Invalide OnPreviewMouseLeftButtonDown para implementar el control de clases para este evento en clases derivadas.

Consulte también

• MouseLeftButtonDown