Control.MouseDoubleClick Ereignis

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Tritt auf, wenn mindestens zwei Mal mit einer Maustaste geklickt wird.

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 

Ereignistyp

MouseButtonEventHandler

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Ereignishandler an das Ereignis angefügt wird MouseDoubleClick .

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

Das folgende Beispiel zeigt den Ereignishandler des Ereignisses MouseDoubleClick .

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

Hinweise

Obwohl dieses Routingereignis einer sprudelnden Route durch eine Elementstruktur zu folgen scheint, handelt es sich tatsächlich um ein direktes Routingereignis, das entlang der Elementstruktur von jedem UIElementausgelöst wird. Wenn Sie die Handled -Eigenschaft in einem MouseDoubleClick Ereignishandler auf true festlegen, werden nachfolgende MouseDoubleClick Ereignisse entlang der Route mit Handled festgelegt auf falseausgeführt. Dies ist ein Ereignis auf höherer Ebene für Steuerelementverbraucher, die benachrichtigt werden möchten, wenn der Benutzer auf das Steuerelement doppelklicken und das Ereignis in einer Anwendung behandeln möchte.

Steuerelementautoren, die Mausdoppelklicks verarbeiten möchten, sollten das MouseLeftButtonDown Ereignis verwenden, wenn ClickCount gleich zwei ist. Dies führt dazu, dass der Zustand von Handled entsprechend weitergegeben wird, wenn ein anderes Element in der Elementstruktur das Ereignis behandelt.

Die Control -Klasse definiert die PreviewMouseDoubleClick Ereignisse und MouseDoubleClick , aber keine entsprechenden Einzelklickereignisse. Um festzustellen, ob der Benutzer einmal auf das Steuerelement geklickt hat, behandeln Sie das MouseDown Ereignis (oder eines seiner Gegenstücke), und überprüfen Sie, ob der ClickCount Eigenschaftswert 1 ist.

Informationen zum Routingereignis

Bezeichnerfeld	MouseDoubleClickEvent
Routingstrategie	Direkt
Delegat	MouseButtonEventHandler