Control.PreviewMouseDoubleClick Zdarzenie

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Występuje, gdy użytkownik klika przycisk myszy co najmniej dwa 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ć program obsługi zdarzeń zdarzenia PreviewMouseDoubleClick .

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

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

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, jest to zdarzenie kierowane bezpośrednio, które jest wywoływane wzdłuż drzewa elementów przez każdy UIElementelement . Jeśli ustawisz Handled właściwość na true w procedurze PreviewMouseDoubleClick obsługi zdarzeń, kolejne PreviewMouseDoubleClick zdarzenia wzdłuż trasy wystąpią z ustawioną wartością falseHandled , ale MouseDoubleClick zdarzenie zostanie ustawione na Handledtruewartość . Jest to zdarzenie wyższego poziomu dla użytkowników sterujących, którzy chcą być powiadamiani, gdy użytkownik dwukrotnie kliknie kontrolkę i obsłuży zdarzenie w aplikacji.

Autorzy kontrolek, którzy chcą obsługiwać dwukrotne kliknięcia myszy, powinni używać 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 wynosi 1.

Informacje dotyczące kierowanego zdarzenia

Pole identyfikatora	PreviewMouseDoubleClickEvent
Strategia routingu	Direct
Delegat	MouseButtonEventHandler