Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

UIElement.MouseLeftButtonDown, événement

Se produit lorsque le bouton gauche de la souris est enfoncé alors que le pointeur est sur cet élément.

Espace de noms :  System.Windows
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public event MouseButtonEventHandler MouseLeftButtonDown
<object MouseLeftButtonDown="MouseButtonEventHandler" .../>

Implémentations

IInputElement.MouseLeftButtonDown

Champ d'identificateur

MouseLeftButtonDownEvent

Stratégie de routage

Direct

Délégué

MouseButtonEventHandler

  • Substituez OnMouseLeftButtonDown pour implémenter la gestion de classe pour cet événement dans les classes dérivées.

Bien que cet événement routé semble suivre un itinéraire par propagation via une arborescence d'éléments, il s'agit en fait d'un événement routé direct qui est déclenché à plusieurs reprises dans l'arborescence d'éléments par chaque UIElement.

Cet événement compte parmi plusieurs événements associés qui signalent les caractéristiques des boutons de la souris pour un événement Mouse.MouseDown sous-jacent, lequel est un événement attaché traité par chaque élément se trouvant sur un itinéraire d'événements.

Les données de cet événement exposent celles de l'événement Mouse.MouseDown sous-jacent. Si cet événement est marqué comme étant géré sur l'itinéraire d'événements, les événements spécifiques aux boutons de la souris sont déclenchés comme d'habitude ; toutefois, les gestionnaires des événements spécifiques aux boutons de la souris doivent être ajoutés en appelant explicitement la méthode AddHandler, avec l'option de gérer les événements qui sont déjà marqués comme étant gérés, afin d'assurer le rôle d'écouteurs de l'événement. Si vous indiquez que MouseLeftButtonDown est géré, cela équivaut à dire que vous marquez essentiellement comme géré Mouse.MouseDown pour tous les écouteurs supplémentaires placés sur l'itinéraire, ainsi que tous les événements associés. Cela peut inclure les événements générés par les gestionnaires de classe, tels que MouseDoubleClick.

D'un point de vue conceptuel, considérez cet événement (ainsi que les autres événements de boutons de la souris portant sur UIElement) comme un "service" souris (dont la définition de service est fournie par la classe Mouse ). L'événement est également pratique dans la mesure où il n'est pas nécessaire de vérifier les états des boutons (droite/gauche, en bas/en haut) des événements de souris d'origine dans les données d'événements. Pour retrouver d'autres scénarios avancés, tels que la vérification des états de boutons non standard, vous pouvez être amené à utiliser les API de la classe Mouse plutôt que ceux portant sur UIElement.

Remarque importanteImportant

Certaines classes de contrôle peuvent disposer d'une gestion de classe inhérente aux événements de boutons de la souris. L'événement de pression du bouton gauche de la souris est le plus susceptible de disposer de la gestion de classe dans un contrôle. La gestion de classe marque souvent l'événement de classe Mouse sous-jacent comme géré. Une fois l'événement marqué comme géré, les autres gestionnaires d'instances attachés à cet élément ne sont généralement pas déclenchés. De même, les autres classes ou gestionnaires d'instances attachés à des éléments dans la direction de propagation vers la racine de l'arborescence de l'interface utilisateur ne sont généralement pas déclenchés.

Vous pouvez utiliser l'une ou l'autre des solutions suivantes pour résoudre le problème décrit dans le paragraphe Important ci-dessus tout en recevant des événements MouseLeftButtonDown pour la pression du bouton gauche de la souris sur une classe dérivée disposant de la gestion de classe :

  • Attachez des gestionnaires pour l'événement PreviewMouseDown, qui n'est pas marqué comme géré par les contrôles. Notez que puisqu'il s'agit d'un événement d'aperçu, l'itinéraire démarre à la racine et crée un tunnel jusqu'au contrôle.

  • Enregistrez un gestionnaire sur le contrôle en appelant AddHandler et en choisissant l'option de signature qui permet aux gestionnaires d'écouter des événements même s'ils sont déjà marqués comme gérés dans les données de l'événement routé.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft