Control.PreviewMouseDoubleClick Événement

Définition

Se produit quand un utilisateur clique sur le bouton de la souris à plusieurs reprises.

C#
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseDoubleClick;

Type d'événement

Exemples

L’exemple suivant montre comment attacher un gestionnaire d’événements à l’événement PreviewMouseDoubleClick .

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

L’exemple suivant montre le gestionnaire d’événements de l’événement PreviewMouseDoubleClick .

C#
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.";
    }
}

Remarques

Bien que cet événement routé semble suivre un itinéraire de tunneling à travers une arborescence d’éléments, il s’agit en fait d’un événement routé direct qui est déclenché le long de l’arborescence d’éléments par chaque UIElement. Si vous définissez la Handled propriété true sur dans un gestionnaire d’événements PreviewMouseDoubleClick , les événements suivants PreviewMouseDoubleClick le long de l’itinéraire se produisent avec Handled la valeur définie sur false, mais l’événement MouseDoubleClick se produit avec Handled la valeur définie sur true. Il s’agit d’un événement de niveau supérieur destiné aux consommateurs de contrôle qui souhaitent être avertis lorsque l’utilisateur double-clique sur le contrôle et de gérer l’événement dans une application.

Les auteurs de contrôle qui souhaitent gérer les doubles clics de souris doivent utiliser l’événement PreviewMouseLeftButtonDown quand ClickCount est égal à deux. Cela entraîne la propagation appropriée de l’état de Handled dans le cas où un autre élément de l’arborescence d’éléments gère l’événement.

La Control classe définit les événements etMouseDoubleClick, mais pas les PreviewMouseDoubleClick événements en un clic correspondants. Pour voir si l’utilisateur a cliqué une fois sur le contrôle, gérez l’événement MouseDown (ou l’un de ses équivalents) et case activée si la valeur de la ClickCount propriété est 1.

Informations sur les événements acheminés

Champ Identificateur PreviewMouseDoubleClickEvent
Stratégie de routage Direct
Délégué MouseButtonEventHandler

S’applique à

Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9