Control.MouseDoubleClick Zdarzenie

Definicja

Występuje po kliknięciu przycisku myszy co najmniej dwa razy.

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 

Typ zdarzenia

Przykłady

W poniższym przykładzie pokazano, jak dołączyć program obsługi zdarzeń do MouseDoubleClick zdarzenia.

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

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

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

Uwagi

Chociaż to zdarzenie kierowane wydaje się podążać drogą bubbling przez drzewo elementów, w rzeczywistości jest to zdarzenie kierowane bezpośrednio, które jest wywoływane wzdłuż drzewa elementów przez każdy UIElementelement . Jeśli właściwość zostanie ustawiona Handled na w procedurze MouseDoubleClick obsługi zdarzeń, kolejne MouseDoubleClick zdarzenia wzdłuż trasy wystąpią z ustawioną wartością Handledfalse.true 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ć MouseLeftButtonDown 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 MouseDoubleClickEvent
Strategia routingu Direct
Delegat MouseButtonEventHandler

Dotyczy