Exporter (0) Imprimer
Développer tout
Développer Réduire

UIElement3D.OnPreviewMouseDown, méthode

Mise à jour : novembre 2007

Appelé lorsqu'un événement routéMouse.PreviewMouseDown attaché non géré atteint un élément sur son itinéraire et dérivé de cette classe. Implémentez cette méthode pour permettre la gestion de classes pour cet événement.

Espace de noms :  System.Windows
Assembly :  PresentationCore (dans PresentationCore.dll)

protected internal virtual void OnPreviewMouseDown(
	MouseButtonEventArgs e
)
protected void OnPreviewMouseDown(
	MouseButtonEventArgs e
)
protected internal function OnPreviewMouseDown(
	e : MouseButtonEventArgs
)
Vous ne pouvez pas utiliser des méthodes en XAML.

Paramètres

e
Type : System.Windows.Input.MouseButtonEventArgs

MouseButtonEventArgs qui contient les données d'événement. Les données des événements signalent qu'un ou plusieurs boutons de la souris ont été appuyés.

Les actions de bouton de souris sont également gérées par un gestionnaire d'entrée dédié. Les autres fonctionnalités de programmation s'appuyant sur des actions de bouton, telles que les liaisons d'entrée et de commandes, peuvent appeler des gestionnaires pour l'action avant qu'elle ne soit exposée comme action générale de bouton de souris. Si ces fonctionnalités du système d'entrée marquent l'événement Mouse.PreviewMouseDown comme géré, OnPreviewMouseDown n'est alors pas appelé.

Si vous utilisez ce gestionnaire de classe pour marquer l'événement comme géré, vous risquez d'influer sur les événements PreviewMouseLeftButtonDown et PreviewMouseRightButtonDown. L'un de ces deux événements peut être déclenché sur l'élément cible lorsque Mouse.PreviewMouseDown est reçu.

Si vous marquez cet événement comme géré lors de la gestion de classe, les sous-événements sont toujours déclenchés, mais ils passent alors l'état de gestion à travers les données d'événement. Si l'événement est géré dans la gestion de classe, les gestionnaires d'instances pour les sous-événements ne sont pas appelés à moins que vous n'utilisiez explicitement AddHandler(RoutedEvent, Delegate, Boolean) avec handledEventsToo ayant la valeur true afin d'attacher les gestionnaires. Les gestionnaires de classe ne sont également pas appelés à moins que ces gestionnaires de classe aient été inscrits avec la signature RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean), avec handledEventsToo ayant la valeur true. En gérant OnPreviewMouseDown, vous indiquez de façon explicite que votre gestion de classe s'est chargée de toutes les actions relatives aux pressions de boutons de la souris. Ce comportement peut s'avérer peu souhaitable. Soyez par conséquent prudent lorsque vous utilisez cette méthode virtuelle pour marquer des événements comme gérés.

Chacun des événements directs spécifiques aux boutons présente également une méthode virtuelle On* ; évaluez si la substitution de ces gestionnaires de classe spécifiques au bouton peut s'avérer plus appropriée.

Cette méthode ne dispose d'aucune implémentation par défaut. Une classe intermédiaire de l'héritage pouvant implémenter cette méthode, nous vous recommandons d'appeler l'implémentation de base dans votre implémentation.

Le but de cette méthode est semblable aux méthodes On* du schéma d'événement Common Language Runtime (CLR) : cette méthode permet de gérer l'événement correspondant depuis des classes dérivées en établissant un gestionnaire de classe plutôt qu'un gestionnaire d'instance. Dans ce cas, l'événement correspondant est un événement routé. Le schéma d'implémentation des méthodes On* est différent pour les événements routés car un événement de ce type peut être déclenché par un élément enfant, qui n'est pas nécessairement l'élément chargé d'appeler les gestionnaires. Par conséquent, votre implémentation doit examiner les propriétés sources des données d'événement. Dans la plupart des cas, elle ne doit pas tenter de redéclencher l'événement.

Que ce soit en substituant cette méthode ou en enregistrant des gestionnaires de classe à l'aide de RegisterClassHandler, les classes dérivées de UIElement3D peuvent appeler des méthodes du gestionnaire de classes privées lorsque l'événement est reçu sur son itinéraire. Un scénario où la gestion de classe s'illustre pleinement est la manipulation des données d'événement et le marquage de l'événement routé comme géré. Un autre scénario prévu spécialement pour les événements Preview est de les marquer comme gérés afin que les gestionnaires de classe par propagation correspondants ne soient pas appelés.

OnPreviewMouseDown est introduit dans le .NET Framework version 3.5. Pour plus d'informations, consultez la page Architecture de .NET Framework 3.5.

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

.NET Framework

Pris en charge dans : 3.5 SP1, 3.0 SP1

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft