Control.PreviewMouseDoubleClick 事件

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

在用户单击鼠标按钮两次或更多次时发生。

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 

事件类型

MouseButtonEventHandler

示例

以下示例演示如何附加事件处理程序 PreviewMouseDoubleClick 事件。

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

以下示例演示 事件的事件处理程序 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

注解

尽管此路由事件似乎遵循通过元素树的隧道路由，但它实际上是一个直接路由事件，由每个 UIElement引发沿元素树引发。 如果在事件处理程序中将 属性设置为 trueHandled ，则路由中的后续PreviewMouseDoubleClick事件将发生，false设置为 Handled ，但事件发生时MouseDoubleClickHandled设置为 true。PreviewMouseDoubleClick 这是一个更高级别的事件，适用于希望在用户双击控件时收到通知并处理应用程序中的事件的控件使用者。

当 等于 2 时ClickCount，控制想要处理鼠标双击的作者应使用 PreviewMouseLeftButtonDown 事件。 当元素树中的另一个元素处理事件时，这将导致 的状态 Handled 适当地传播。

类Control定义 和 MouseDoubleClick 事件，但不定义PreviewMouseDoubleClick相应的单击事件。 若要查看用户是否已单击控件一次，请) 处理MouseDown事件 (或其对应项之一，并检查属性值是否ClickCount为 1。

路由事件信息

标识符字段	PreviewMouseDoubleClickEvent
路由策略	直接
委托	MouseButtonEventHandler