Control.PreviewMouseDoubleClick Evento

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ocorre quando um usuário clica no botão do mouse duas ou mais vezes.

public:
 event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseDoubleClick;

public event System.Windows.Input.MouseButtonEventHandler PreviewMouseDoubleClick;

member this.PreviewMouseDoubleClick : System.Windows.Input.MouseButtonEventHandler 

Public Custom Event PreviewMouseDoubleClick As MouseButtonEventHandler 

Tipo de evento

MouseButtonEventHandler

Exemplos

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

<Button Name="btn1" Foreground="Black" 
        PreviewMouseDoubleClick="ChangeForeground">
  Foreground
</Button>

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

void ChangeForeground(object sender, RoutedEventArgs e)
{
    if (btn1.Foreground == Brushes.Green)
    {
        btn1.Foreground = Brushes.Black;
        btn1.Content = "Foreground";
    }
    else
    {
        btn1.Foreground = Brushes.Green;
        btn1.Content = "Control foreground(text) changes from black to green.";
    }
}

Private Sub ChangeForeground(ByVal Sender As Object, ByVal e As System.Windows.Input.MouseButtonEventArgs)

    If (btn1.Foreground Is Brushes.Green) Then
        btn1.Foreground = Brushes.Black
        btn1.Content = "Foreground"
    Else
        btn1.Foreground = Brushes.Green
        btn1.Content = "Control foreground(text) changes from black to green."
    End If

End Sub

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 ao longo da árvore de elementos por cada UIElementum. Se você definir a Handled propriedade como em um PreviewMouseDoubleClick manipulador de eventos, eventos subsequentes PreviewMouseDoubleClick ao longo da rota ocorrerão com Handled definido como false, mas o MouseDoubleClick evento ocorrerá com definido como Handledtrue.true Esse é um evento de nível superior para 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 PreviewMouseLeftButtonDown evento quando ClickCount for igual a dois. Isso fará com que o estado de Handled propagação seja propagado adequadamente no caso em que outro elemento na árvore de elementos manipula o evento.

A Control classe define os eventos e MouseDoubleClick os PreviewMouseDoubleClick eventos, mas não os 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 verifique se o valor da ClickCount propriedade é 1.

Informações do evento roteado

Item	Valor
Campo identificador	PreviewMouseDoubleClickEvent
Estratégia de roteamento	Direto
Delegado	MouseButtonEventHandler