UIElement.PreviewMouseLeftButtonDown Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 |
- Substitua OnPreviewMouseLeftButtonDown para implementar o tratamento de classe para esse evento em classes derivadas.
