Partilhar via


ContentElement.PreviewMouseLeftButtonDown Evento

Definição

Ocorre quando o botão esquerdo do mouse é pressionado enquanto o ponteiro do mouse está 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

Implementações

Comentários

Embora essa Visão Geral de Eventos Roteados pareça seguir uma rota de túnel por meio de uma árvore de elementos, na verdade é um evento roteado direto que é gerado e reraizado ao longo da árvore de elementos por cada ContentElement.

Esse evento é um dos vários eventos relacionados que relatam as especificidades do botão do mouse de um evento subjacente Mouse.PreviewMouseDown , que é um evento anexado que é processado por cada elemento ao longo de uma rota de evento.

Os argumentos desse evento expõem os argumentos do evento subjacente Mouse.PreviewMouseDown . Se esse evento estiver marcado como manipulado ao longo da rota do evento, os eventos específicos do botão do mouse ainda serão acionados; no entanto, os manipuladores dos eventos específicos do botão do mouse devem ser adicionados chamando AddHandlerexplicitamente , com a opção de manipular eventos que já estão marcados como manipulados para serem ouvintes do evento.

Conceitualmente, considere esse evento (e outros eventos de botão do mouse em ContentElement) como um "serviço" do mouse (com a definição de serviço fornecida pela Mouse classe ). O evento adiciona a conveniência de não precisar marcar os estados do botão do mouse (esquerdo-direito, para cima) dos eventos originais do mouse nos dados do evento. Para cenários mais avançados, como a verificação de estados de botões não padrão, talvez seja necessário usar as APIs na classe em Mouse vez daquelas em ContentElement.

Informações de evento encaminhado

Campo Identificador PreviewMouseLeftButtonDownEvent
Estratégia de roteamento Direto
Delegar MouseButtonEventHandler

Aplica-se a

Confira também