Control.MouseDoubleClick Evento

Definición

Se produce al hacer clic en un botón del mouse dos o más veces.

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 

Tipo de evento

Ejemplos

En el ejemplo siguiente se muestra cómo adjuntar un controlador de eventos al MouseDoubleClick evento.

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

En el ejemplo siguiente se muestra el controlador de eventos del MouseDoubleClick evento.

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

Comentarios

Aunque este evento enrutado parece seguir una ruta de propagación a través de un árbol de elementos, en realidad es un evento enrutado directo que se genera a lo largo del árbol de elementos por cada UIElement. Si establece la Handled propiedad true en en un MouseDoubleClick controlador de eventos, los eventos posteriores MouseDoubleClick a lo largo de la ruta se producirán con Handled establecido en false. Se trata de un evento de nivel superior para los consumidores de control que quieren recibir notificaciones cuando el usuario hace doble clic en el control y para controlar el evento en una aplicación.

Los autores de controles que quieran controlar los doble clics del mouse deben usar el MouseLeftButtonDown evento cuando ClickCount es igual a dos. Esto hará que el estado de Handled se propague correctamente en el caso de que otro elemento del árbol de elementos controle el evento.

La Control clase define los PreviewMouseDoubleClick eventos y MouseDoubleClick , pero no los eventos de clic único correspondientes. Para ver si el usuario ha hecho clic en el control una vez, controle el MouseDown evento (o uno de sus homólogos) y compruebe si el valor de la ClickCount propiedad es 1.

Información sobre eventos enrutados

Campo identificador MouseDoubleClickEvent
Estrategia de enrutamiento Directo
Delegado MouseButtonEventHandler

Se aplica a