Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

UIElement3D.OnPreviewMouseUp méthode (MouseButtonEventArgs)

 

Date de publication : novembre 2016

Méthode appelée quand un événement attaché Mouse.PreviewMouseUp non géré atteint un élément de son itinéraire qui est dérivé de cette classe. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.

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

protected internal virtual void OnPreviewMouseUp(
	MouseButtonEventArgs e
)

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é relâchés.

Les actions de bouton de souris sont également gérées par un gestionnaire d’entrée dédié. Autres fonctionnalités de programmation qui s’appuient sur les actions de bouton, comme entrée et les commandes des liaisons, peuvent appeler des gestionnaires pour l’action avant qu’elle est exposée comme une action de bouton de souris général. Si ces d’entrée système fonctionnalités marque le Mouse.PreviewMouseUp événement comme géré, OnPreviewMouseUp n’est 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 suivants : PreviewMouseLeftButtonUp et PreviewMouseRightButtonUp. Un de ces événements peuvent être déclenché sur l’élément cible lorsque Mouse.PreviewMouseUp est reçue.

Si vous marquez cet événement comme géré dans la gestion de classe, les sous-événements sont toujours déclenchés ; Toutefois, elles passent de l’état géré dans 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 utilisiez explicitement AddHandler(RoutedEvent, Delegate, Boolean) avec handledEventsToo true pour joindre des gestionnaires.  Les gestionnaires de classe sont également pas appelés à moins que ces gestionnaires de classe ont été enregistrés avec le RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) signature avec handledEventsToo true En gérant OnPreviewMouseUp, vous est pressions que votre gestion de classe pour tous les boutons de la souris des actions. Ce comportement peut être indésirable. Par conséquent, soyez prudent lorsque vous utilisez cette méthode virtuelle pour marquer des événements comme gérés.

Chacun des événements directs spécifiques bouton possède également un ordinateur virtuel, * méthode ; Considérez si la substitution de ces gestionnaires de classe spécifiques au bouton peut être plus approprié.

Cette méthode n'a aucune implémentation par défaut. Car une classe intermédiaire dans l'héritage peut implémenter cette méthode, nous vous recommandons d'appeler l'implémentation de base dans votre implémentation.

L'objectif de cette méthode est similaire à la Common Language Runtime (CLR) modèle d'événement sur * méthodes : cette méthode permet de gérer l'événement correspondant depuis des classes dérivées en établissant un gestionnaire de classe au lieu d'un gestionnaire d'instance. Dans ce cas, l'événement correspondant est un événement routé. Le modèle d'implémentation des méthodes On * est différent pour les événements routés car un événement routé peut être déclenché par un élément enfant, qui n'est pas nécessairement l'élément qui appelle les gestionnaires. Par conséquent, votre implémentation doit examiner les propriétés de la source des données d'événement. Il ne doit pas tenter de redéclencher l'événement dans la plupart des cas.

En substituant cette méthode ou en enregistrant des gestionnaires avec de classe RegisterClassHandler, les classes dérivées de UIElement3D peut appeler des méthodes de gestionnaire de classes privées lorsque l'événement est reçu sur son itinéraire. Un scénario où la gestion de classe est appropriée consiste à manipuler les données d'événement et de marquer l'événement routé comme géré.

OnPreviewMouseUp est introduit dans le .NET Framework version 3.5. Pour plus d'informations, consultez Versions et dépendances du .NET Framework.

.NET Framework
Disponible depuis 3.0
Retour au début
Afficher: