Partilhar via


Control.MouseDoubleClick Evento

Definição

Ocorre quando um botão do mouse é clicado duas vezes ou mais.

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

Tipo de evento

Exemplos

O exemplo a seguir mostra como anexar um manipulador de eventos ao MouseDoubleClick evento.

<Button Name="btn" Background="Red" 
        MouseDoubleClick="ChangeBackground">
  Background
</Button>

O exemplo a seguir mostra o manipulador de eventos do MouseDoubleClick evento.

void ChangeBackground(object sender, RoutedEventArgs e)
{
    if (btn.Background == Brushes.Red)
    {
        btn.Background = new LinearGradientBrush(Colors.LightBlue, Colors.SlateBlue, 90);
        btn.Content = "Control background changes from red to a blue gradient.";
    }
    else
    {
        btn.Background = Brushes.Red;
        btn.Content = "Background";
    }
}
Private Sub ChangeBackground(ByVal Sender As Object, ByVal e As System.Windows.Input.MouseButtonEventArgs)

    If (btn.Background Is Brushes.Red) Then

        btn.Background = New LinearGradientBrush(Colors.LightBlue, Colors.SlateBlue, 90)
        btn.Content = "Control background changes from red to a blue gradient."

    Else
        btn.Background = Brushes.Red
        btn.Content = "Background"
    End If

End Sub

Comentários

Embora esse evento roteado pareça seguir uma rota borbulhante por meio de uma árvore de elementos, na verdade é um evento roteado direto que é gerado ao longo da árvore de elementos por cada UIElement. Se você definir a Handled propriedade como true em um MouseDoubleClick manipulador de eventos, eventos subsequentes MouseDoubleClick ao longo da rota ocorrerão com definido falsecomo Handled . Esse é um evento de nível superior para os consumidores de controle que desejam ser notificados quando o usuário clica duas vezes no controle e para manipular o evento em um aplicativo.

Os autores de controle que desejam manipular cliques duplos do mouse devem usar o MouseLeftButtonDown evento quando ClickCount for igual a dois. Isso fará com que o estado de Handled se propague adequadamente no caso em que outro elemento na árvore de elementos manipula o evento.

A Control classe define os PreviewMouseDoubleClick eventos e MouseDoubleClick , mas não eventos de clique único correspondentes. Para ver se o usuário clicou no controle uma vez, manipule o MouseDown evento (ou um de seus equivalentes) e marcar se o valor da ClickCount propriedade é 1.

Informações de evento encaminhado

Campo Identificador MouseDoubleClickEvent
Estratégia de roteamento Direto
Delegar MouseButtonEventHandler

Aplica-se a