Control.PreviewMouseDoubleClick Zdarzenie

Definicja

Występuje, gdy użytkownik klika przycisk myszy dwa lub więcej razy.

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 

Typ zdarzenia

MouseButtonEventHandler

Przykłady

W poniższym przykładzie pokazano, jak dołączyć zdarzenie obsługi PreviewMouseDoubleClick zdarzeń.

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

Poniższy przykład przedstawia procedurę obsługi zdarzeń zdarzenia PreviewMouseDoubleClick .

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

Uwagi

Chociaż to zdarzenie kierowane wydaje się podążać za trasą tunelowania przez drzewo elementów, w rzeczywistości jest to bezpośrednie zdarzenie kierowane, które jest wywoływane wzdłuż drzewa elementów przez każdy UIElementelement . Jeśli właściwość zostanie ustawiona Handled na true w procedurze PreviewMouseDoubleClick obsługi zdarzeń, kolejne PreviewMouseDoubleClick zdarzenia wzdłuż trasy zostaną wykonane z ustawioną Handled wartością false, ale MouseDoubleClick zdarzenie zostanie ustawione Handled na truewartość . Jest to zdarzenie wyższego poziomu dla użytkowników kontroli, którzy chcą otrzymywać powiadomienia, gdy użytkownik dwukrotnie kliknie kontrolkę i obsłuży zdarzenie w aplikacji.

Kontroluj autorów, którzy chcą obsługiwać dwukrotne kliknięcia myszy, powinni użyć PreviewMouseLeftButtonDown zdarzenia, gdy ClickCount jest równe dwa. Spowoduje to odpowiednie propagowanie stanu Handled propagacji w przypadku, gdy inny element w drzewie elementów obsługuje zdarzenie.

Klasa Control definiuje PreviewMouseDoubleClick zdarzenia i MouseDoubleClick , ale nie odpowiadające im zdarzenia pojedynczego kliknięcia. Aby sprawdzić, czy użytkownik kliknął kontrolkę raz, obsłuż MouseDown zdarzenie (lub jeden z jego odpowiedników) i sprawdź, czy ClickCount wartość właściwości to 1.

Informacje dotyczące kierowanego zdarzenia

Pole identyfikatora PreviewMouseDoubleClickEvent
Strategia routingu Direct
Delegat MouseButtonEventHandler

Dotyczy