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элементом . Если для свойства задано Handled значение true в обработчике PreviewMouseDoubleClick событий, последующие PreviewMouseDoubleClick события по маршруту будут возникать с Handled параметром , для свойства задано значение false, но MouseDoubleClick событие будет происходить с Handled значением true. Это событие более высокого уровня для потребителей элементов управления, которые хотят получать уведомления, когда пользователь дважды щелкает элемент управления и обрабатывает событие в приложении.

Авторы элементов управления, которые хотят обрабатывать двойные щелчки мышью, должны использовать событие , PreviewMouseLeftButtonDown если ClickCount равно двум. Это приведет к тому, что состояние Handled будет распространяться соответствующим образом в случае, когда другой элемент в дереве элементов обрабатывает событие.

Класс Control определяет PreviewMouseDoubleClick события и MouseDoubleClick , но не соответствующие события одним щелчком мыши. Чтобы проверить, щелкнул ли пользователь элемент управления один раз, обработайте MouseDown событие (или один из его аналогов) и проверка, равно ли ClickCount значение свойства 1.

Сведения о маршрутизируемом событии

Поле идентификатора	PreviewMouseDoubleClickEvent
Стратегия маршрутизации	Прямой доступ
Делегат	MouseButtonEventHandler