UIElement.MouseDown Event

Definition

Ocorre quando qualquer botão do mouse é pressionado enquanto o ponteiro está sobre este elemento.Occurs when any mouse button is pressed while the pointer is over this element.

public:
 event System::Windows::Input::MouseButtonEventHandler ^ MouseDown;
public event System.Windows.Input.MouseButtonEventHandler MouseDown;
member this.MouseDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event MouseDown As MouseButtonEventHandler 

Remarks

Esse evento cria um alias para o evento Mouse.MouseDown anexado para essa classe, de modo que MouseDown faz parte da lista de membros da classe quando UIElement é herdado como um elemento base.This event creates an alias for the Mouse.MouseDown attached event for this class, so that MouseDown is part of the class members list when UIElement is inherited as a base element. Os manipuladores de eventos anexados ao evento MouseDown são anexados ao evento subjacente Mouse.MouseDown anexado e recebem a mesma instância de dados de evento.Event handlers that are attached to the MouseDown event are attached to the underlying Mouse.MouseDown attached event and receive the same event data instance.

O evento MouseDown muitas vezes é aumentado com MouseLeftButtonDown ou MouseRightButtonDown, que correspondem a uma prensa de um dos dois botões padrão do mouse.The MouseDown event is often raised together with either MouseLeftButtonDown or MouseRightButtonDown, which correspond to a press of one of the two standard mouse buttons. MouseLeftButtonDown e MouseRightButtonDown também são eventos roteados, mas são eventos roteados diretos, e o evento apropriado específico do botão é gerado quando o evento Mouse.MouseDown atinge esse elemento ao longo da rota do evento.MouseLeftButtonDown and MouseRightButtonDown are also routed events, but they are direct routed events, and the appropriate button-specific event is raised when the Mouse.MouseDown event reaches this element along the event route. Consulte comentários para MouseLeftButtonDown ou MouseRightButtonDown.See Remarks for MouseLeftButtonDown or MouseRightButtonDown.

Important

Alguns controles podem ter manipulação de classe inerente para eventos de botão do mouse.Some controls might have inherent class handling for mouse button events. O evento do botão esquerdo do mouse é o evento mais provável para ter manipulação de classe em um controle.The left mouse button down event is the most likely event to have class handling in a control. A manipulação de classe geralmente marca o evento de classe de Mouse subjacente como manipulado.The class handling often marks the underlying Mouse class event as handled. Depois que o evento é marcado como manipulado, outros manipuladores de instância anexados a esse elemento não são gerados normalmente.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Quaisquer outros manipuladores de classe ou de instância anexados a elementos na direção de bolha em direção à raiz na árvore de interface do usuário também não são gerados normalmente.Any other class or instance handlers that are attached to elements in the bubbling direction towards the root in the UI tree are also not ordinarily raised.

Você pode resolver o problema descrito no importante anterior e ainda receber eventos de MouseDown para os eventos do botão esquerdo do mouse para baixo em uma classe derivada que tem manipulação de classe usando uma destas soluções:You can resolve the issue that is outlined in the preceding Important and still receive MouseDown events for left mouse button down events on a derived class that has class handling by using either of these solutions:

  • Anexe manipuladores para o evento PreviewMouseDown, que não está marcado como manipulado pelos controles.Attach handlers for the PreviewMouseDown event, which is not marked as handled by the controls. Observe que, como esse é um evento de visualização, a rota começa na raiz e faz o túnel para baixo até o controle.Notice that because this is a preview event, the route starts at the root and tunnels down to the control.

  • Registre um manipulador no controle em procedimento chamando AddHandler e escolhendo a opção de assinatura que permite que os manipuladores escutem eventos, mesmo que eles já estejam marcados como manipulados nos dados do evento roteado.Register a handler on the control procedurally by calling AddHandler and choosing the signature option that enables handlers to listen for events even if they are already marked as handled in the routed event data.

Informações Sobre Eventos RoteadosRouted Event Information

Campo de identificadorIdentifier field MouseDownEvent
Estratégia de roteamentoRouting strategy PropagaçãoBubbling
DelegadoDelegate MouseButtonEventHandler
  • O evento de encapsulamento correspondente é PreviewMouseDown.The corresponding tunneling event is PreviewMouseDown.

  • Substitua OnMouseDown para implementar a manipulação de classe para esse evento em classes derivadas.Override OnMouseDown to implement class handling for this event in derived classes.

Applies to