UIElement3D.MouseLeftButtonDown (Evento)

public event MouseButtonEventHandler MouseLeftButtonDown

<object MouseLeftButtonDown="MouseButtonEventHandler" .../>

Implementaciones

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

Aunque el ejemplo de Información general sobre eventos enrutados parece seguir una ruta de propagación por un árbol de elementos, en realidad es un evento enrutado directo que cada UIElement3D provoca y vuelve a provocar en el árbol de elementos.

Este evento es uno de los diversos eventos relacionados que notifican información específica sobre los botones del mouse de un evento Mouse.MouseDown subyacente, que es un evento adjunto procesado por cada elemento a lo largo de una ruta de evento.

Los datos de este evento exponen los datos del evento Mouse.MouseDown subyacente. Si ese evento está marcado como controlado en la ruta de evento, se siguen provocando los eventos específicos de los botones del mouse; sin embargo, los controladores de los eventos específicos de los botones del mouse se deben agregar llamando explícitamente a AddHandler, con la opción de controlar los eventos que ya están marcados como controlados, para que sean los agentes de escucha del evento. Si marca MouseLeftButtonDown como controlado, está marcando fundamentalmente Mouse.MouseDown como controlado para todos los demás agentes de escucha a lo largo de la ruta y en todos los eventos relacionados. Esto posiblemente incluye los eventos generados por el controlador de clases, como MouseDoubleClick.

Conceptualmente, considere este evento (y otros eventos de los botones del mouse en UIElement3D) como un "servicio" del mouse (con la definición de servicio proporcionada por la clase Mouse). El evento evita la necesidad de comprobar los estados de los botones del mouse (primario-secundario, sin presionar-presionado) de los eventos de mouse originales en los datos del evento. En escenarios más avanzados, como la comprobación de los estados de botones no estándar, quizá deba usar las APIs de la clase Mouse en vez de las de UIElement3D.

Importante
El control de clases suele marcar el evento subyacente de la clase Mouse como controlado. Cuando el evento está marcado como controlado, no suelen usarse otros controladores de instancias asociados a ese elemento. Tampoco suele usarse ningún otro controlador de clases o instancias asociado a los elementos en la dirección de propagación hacia la raíz del árbol de la interfaz de usuario.

Para resolver el problema que se describe en la sección Importante anterior y seguir recibiendo los eventos MouseLeftButtonDown de pulsación del botón primario del mouse en una clase derivada que tiene el control de clases, aplique cualquiera de estas soluciones:

• Asocie controladores para el evento PreviewMouseDown, que no está marcado como controlado por los controles. Tenga en cuenta que al tratarse de un evento de vista previa, la ruta empieza en la raíz y desciende hasta el control.

• Registre un controlador en el control mediante procedimientos llamando a AddHandler y eligiendo la opción de firma que habilite los controladores para que escuchen los eventos aunque estén marcados como controlados en los datos del evento enrutado.

MouseLeftButtonDown aparece por primera vez en .NET Framework versión 3.5. Para obtener más información, vea Versiones y dependencias de .NET Framework.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos