Compartilhar via


UIElement.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 esse evento roteado 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 UIElement.

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 dados de evento desse evento expõem os dados de evento 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. Se você marcar PreviewMouseLeftButtonDown manipulado, estará essencialmente marcando Mouse.PreviewMouseDown manipulado para todos os ouvintes adicionais ao longo da rota e em todos os eventos relacionados. Isso possivelmente inclui eventos gerados pelo manipulador de classe, como PreviewMouseDoubleClick.

Conceitualmente, considere esse evento (e outros eventos de botão do mouse em UIElement) 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 UIElement.

Informações de evento encaminhado

Campo Identificador PreviewMouseLeftButtonDownEvent
Estratégia de roteamento Direto
Delegar MouseButtonEventHandler

Aplica-se a

Confira também