UIElement.PreviewMouseLeftButtonDown Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
- Invalide OnPreviewMouseLeftButtonDown para implementar el control de clases para este evento en clases derivadas.
