Control.MouseDoubleClick Zdarzenie

Definicja

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

C#
public event System.Windows.Input.MouseButtonEventHandler MouseDoubleClick;

Typ zdarzenia

Przykłady

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

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

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

C#
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";
    }
}

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

Produkt Wersje
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9