UIElement.OnMouseLeftButtonDown(MouseButtonEventArgs) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Invocado quando um evento roteado MouseLeftButtonDown sem tratamento é gerado nesse elemento. Implemente esse método para adicionar tratamento de classe a esse evento.

protected:
 virtual void OnMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected virtual void OnMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Overridable Sub OnMouseLeftButtonDown (e As MouseButtonEventArgs)

Parâmetros

e

MouseButtonEventArgs

O MouseButtonEventArgs que contém os dados do evento. Os dados do evento relatam que o botão esquerdo do mouse foi pressionado.

Comentários

O MouseLeftButtonDown evento parece viajar por uma rota borbulhante, mas na verdade viaja de forma indireta. Mouse.MouseDown é o evento subjacente que é roteado por bolha e cada UIElement um ao longo da rota de evento usa manipulação idêntica para gerar o evento MouseLeftButtonDownroteado direto. Embora você possa marcar o MouseLeftButtonDown evento como manipulado para fins desse elemento, o estado manipulado não perpetua para outros elementos ao longo da rota do evento. No entanto, talvez você queira marcar o evento como manipulado para impedir que manipuladores de instância geral (aqueles que não especificaram handledEventsToo) sejam invocados.

A implementação padrão para manipulação geral de eventos do mouse em escuta Mouse.MouseDown e a converte em UIElement um evento local apropriado. Se você quiser substituir essa lógica, deverá criar uma classe derivada. No construtor estático da classe derivada, registre um manipulador de classe alternativa para Mouse.MouseDown. Você não pode alterar o comportamento de tratamento do mouse de UIElement substituindo OnMouseLeftButtonDown.

Como alternativa, você pode substituir esse método para alterar o tratamento de eventos para um estado específico do mouse. Se você optar por chamar a implementação base depende do seu cenário. Falha ao chamar base desabilita o tratamento de entrada padrão para esse evento de mouse em classes ancestrais que também esperam invocar OnMouseLeftButtonDown. Por exemplo, você pode derivar de Button e substituir OnMouseLeftButtonDown em sua classe derivada sem chamar a implementação base; no entanto, essa substituição desabilita o Click evento.