Windows Dev Center

Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Informações
O tópico solicitado está sendo mostrado abaixo. No entanto, este tópico não está incluído nesta biblioteca.

Evento UIElement.MouseLeftButtonDown

Ocorre quando o botão esquerdo do mouse é pressionado enquanto o ponteiro do mouse está sobre esse elemento.

Namespace:  System.Windows
Assembly:  PresentationCore (em PresentationCore.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public event MouseButtonEventHandler MouseLeftButtonDown
<object MouseLeftButtonDown="MouseButtonEventHandler" .../>

Implementações

IInputElement.MouseLeftButtonDown

Campo identificador

MouseLeftButtonDownEvent

Estratégia de roteamento

Direto

delegate

MouseButtonEventHandler

  • Substituir OnMouseLeftButtonDown para implementar classe tratamento para este evento em classes derivadas.

Embora isso roteados eventos parece siga uma subida rota através de uma árvore de elementos é realmente um direct evento roteado que é gerado e geradas novamente ao longo da árvore de elementos por cada UIElement.

Este evento é um dos vários eventos relacionados que relatam as especificidades de botão do mouse de uma base Mouse.MouseDown o evento, que é um evento anexado que é processado pelo cada elemento ao longo de uma rota de evento.

Os dados do evento desse evento expõe os dados do evento da Mouse.MouseDown de evento. Se esse evento é marcado como manipulado na rota de evento, os eventos específicos do botão do mouse ainda são gerados; No entanto, os manipuladores de eventos específicos de botão do mouse devem ser adicionados explicitamente chamando AddHandler, com a opção para manipular eventos que já estão marcados como manipulado, para ser ouvintes para o evento. Se você marcar MouseLeftButtonDown tratados, é essencialmente marcando Mouse.MouseDown tratados para todos os outros ouvintes ao longo da rota e em todos os eventos relacionados. Isso possivelmente inclui os eventos de manipulador de classe gerado como MouseDoubleClick.

Conceitualmente, considere esse evento (e outros eventos de botão do mouse em UIElement) para ser um mouse "serviço" (com a definição de serviço fornecida pelo Mouse classe). O evento adiciona a conveniência de não precisar verificar os estados de botão do mouse (esquerda-direita, para cima para baixo) dos eventos de mouse original nos dados de evento. Para cenários mais avançados, como verificação de estados dos botões não padrão, talvez você precise usar o APIs sobre o Mouse classe em vez daquelas em UIElement.

Observação importanteImportante

Algumas classes de controle podem ter inerente classe tratamento de eventos de botão do mouse. O botão esquerdo do mouse para baixo do evento é o evento mais provável ter um controle de manipulação de classe. A classe tratamento geralmente marca base Mouse eventos de classe como manipulado. Depois que o evento é marcado como manipulado, outros manipuladores de instância que estão anexados a esse elemento normalmente não são gerados. Qualquer outras classe ou instância manipuladores que estão anexados a elementos de bubbling direção na direção de raiz na árvore de interface do usuário também não normalmente são gerados.

Você pode resolver o problema descrito no item anterior importante e ainda receber MouseLeftButtonDown eventos para o botão esquerdo do mouse para baixo de eventos em uma classe derivada, tem tratamento usando qualquer uma dessas soluções de classe:

  • Anexar manipuladores para o PreviewMouseDown o evento, que não está marcado como manipulado por controles. Observe que, porque esse é um evento de visualização, a rota começa na raiz e encapsulamentos para baixo para o controle.

  • Registra um manipulador no controle com procedimentos chamando AddHandler e escolhendo a opção de assinatura que permite que os manipuladores escutar eventos mesmo se já estiver marcados como manipulado no evento roteado dados.

.NET Framework

Com suporte em: 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Contribuições da comunidade

Mostrar:
© 2015 Microsoft