UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Método

Definición

Se invoca cuando un evento enrutado PreviewMouseLeftButtonDown no controlado alcanza un elemento derivado de esta clase en su ruta. Implemente este método a fin de agregar el control de clases para este evento.

protected:
 virtual void OnPreviewMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);
protected virtual void OnPreviewMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);
abstract member OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
Protected Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

Parámetros

e
MouseButtonEventArgs

Objeto MouseButtonEventArgs que contiene los datos del evento. Los datos del evento indican que se presionó el botón primario del mouse.

Comentarios

El PreviewMouseLeftButtonDown evento parece viajar por una ruta de tunelización, pero realmente viaja de forma indirecta. Mouse.PreviewMouseDown es el evento subyacente en el que se enruta el túnel y cada uno de ellos UIElement a lo largo de la ruta de eventos usa un control idéntico para generar el evento PreviewMouseLeftButtonDownenrutado directo . Aunque puede marcar el PreviewMouseLeftButtonDown evento como controlado con fines de este elemento, el estado controlado no se perpetua en otros elementos a lo largo de la ruta de eventos. Sin embargo, es posible que quiera marcar el evento como controlado para evitar que se invoquen controladores de instancias generales (aquellos que no especificaron handledEventsToo).

La implementación predeterminada para el control general de eventos del mouse en UIElement escucha y Mouse.PreviewMouseDown la convierte en un evento local adecuado. Si desea invalidar esta lógica, debe crear una clase derivada. En el constructor estático de la clase derivada, registre un controlador de clase alternativo para Mouse.PreviewMouseDown. No se puede cambiar el comportamiento de control del mouse de UIElement invalidando OnPreviewMouseLeftButtonDown.

Como alternativa, puede invalidar este método para cambiar el control de eventos de un estado específico del mouse. Si decide llamar a la implementación base depende de su escenario. No se puede llamar a base deshabilita el control de entrada predeterminado para ese evento del mouse en las clases antecesoras que también esperan invocar OnPreviewMouseLeftButtonDown. Por ejemplo, puede derivar de Button e invalidar OnPreviewMouseLeftButtonDown en la clase derivada sin llamar a la implementación base; sin embargo, esta invalidación deshabilita el Click evento.

Se aplica a