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 UIElement. Se você definir a Handled propriedade como true em um PreviewMouseDoubleClick manipulador de eventos, eventos subsequentes PreviewMouseDoubleClick ao longo da rota ocorrerão com definido falsecomo Handled , mas o MouseDoubleClick evento ocorrerá com definido truecomo 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 PreviewMouseLeftButtonDown 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	PreviewMouseDoubleClickEvent
Estratégia de roteamento	Direto
Delegar	MouseButtonEventHandler