Control.MouseDoubleClick Control.MouseDoubleClick Control.MouseDoubleClick Control.MouseDoubleClick Event

Определение

Вызывается при нажатии кнопки мыши два или более раз.Occurs when a mouse button is clicked two or more times.

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 

Примеры

В следующем примере показано, как подключить обработчик событий к MouseDoubleClick событию.The following example shows how to attach an event handler to the MouseDoubleClick event.

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

В следующем примере показан обработчик MouseDoubleClick событий события.The following example shows the event handler of the MouseDoubleClick event.

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

Комментарии

Несмотря на то, что перенаправленное событие кажется следовать направленному маршруту через дерево элементов, оно фактически является прямым перенаправленным событием, которое создается по дереву UIElementэлементов каждым из них.Although this routed event seems to follow a bubbling route through an element tree, it actually is a direct routed event that is raised along the element tree by each UIElement. Если Handled задать falseдля true свойства значение в MouseDoubleClick обработчике событий, последующие MouseDoubleClick события в маршруте будут выполняться с Handled параметром.If you set the Handled property to true in a MouseDoubleClick event handler, subsequent MouseDoubleClick events along the route will occur with Handled set to false. Это событие более высокого уровня для потребителей элементов управления, которые хотят получать уведомления о том, что пользователь дважды щелкает элемент управления и обрабатывает событие в приложении.This is a higher-level event for control consumers who want to be notified when the user double-clicks the control and to handle the event in an application.

Авторы элементов управления, желающие управлять двойными щелчками мышью MouseLeftButtonDown , должны ClickCount использовать событие, если равно двум.Control authors who want to handle mouse double clicks should use the MouseLeftButtonDown event when ClickCount is equal to two. Это приведет к тому, что Handled состояние будет распространяться соответствующим образом в случае, когда другой элемент в дереве элементов обрабатывает событие.This will cause the state of Handled to propagate appropriately in the case where another element in the element tree handles the event.

Класс определяет событияMouseDoubleClick и, но не соответствующие события одинарного щелчка. PreviewMouseDoubleClick ControlThe Control class defines the PreviewMouseDoubleClick and MouseDoubleClick events, but not corresponding single-click events. Чтобы увидеть, был ли пользователь щелкнул элемент управления один раз, обработайте MouseDown событие (или один из его аналога) и проверьте, равно ClickCount ли значение свойства 1.To see if the user has clicked the control once, handle the MouseDown event (or one of its counterparts) and check whether the ClickCount property value is 1.

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

Поле идентификатораIdentifier field MouseDoubleClickEvent
Стратегия маршрутизацииRouting strategy DirectDirect
делегатDelegate MouseButtonEventHandler

Применяется к