Control.PreviewMouseDoubleClick Ereignis

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Tritt auf, wenn ein Benutzer mindestens zweimal die Maustaste drückt.

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 

Ereignistyp

MouseButtonEventHandler

Beispiele

Das folgende Beispiel zeigt, wie ein Ereignishandler an das Ereignis angefügt wird PreviewMouseDoubleClick .

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

Das folgende Beispiel zeigt den Ereignishandler des Ereignisses 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

Hinweise

Obwohl dieses Routingereignis einer Tunnelroute 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 PreviewMouseDoubleClick Ereignishandler auf true festlegen, werden nachfolgende PreviewMouseDoubleClick Ereignisse entlang der Route mit Handled auf festgelegtfalse, das Ereignis tritt jedoch MouseDoubleClick auf Handledtrue. Dies ist ein Ereignis auf höherer Ebene für Steuerelementconsumer, die benachrichtigt werden möchten, wenn der Benutzer auf das Steuerelement doppelklicken und das Ereignis in einer Anwendung behandeln soll.

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

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

Informationen zum Routingereignis

Bezeichnerfeld	PreviewMouseDoubleClickEvent
Routingstrategie	Direkt
Delegat	MouseButtonEventHandler