ContentElement.OnMouseLeftButtonDown(MouseButtonEventArgs) Método

Definição

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

protected public:
 virtual void OnMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);
protected internal 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 Friend 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 ContentElement 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 tratado para impedir que manipuladores de instância geral (aqueles que não especificaram handledEventsToo) sejam invocados.

A implementação padrão para o tratamento geral de eventos do mouse em escutas Mouse.MouseDown e converte-a em ContentElement 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 alternativo para Mouse.MouseDown. Não é possível alterar o comportamento de tratamento do ContentElement mouse 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 Button e substituir OnMouseLeftButtonDown em sua classe derivada sem chamar a implementação base; no entanto, essa substituição desabilita o Click evento.

Aplica-se a