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

UIElement3D.OnPreviewMouseUp, méthode

Appelé lorsqu'un événement attaché Mouse.PreviewMouseUp non géré atteint un élément sur son itinéraire 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 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é. 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.PreviewMouseUp comme géré, OnPreviewMouseUp 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 PreviewMouseLeftButtonUp et PreviewMouseRightButtonUp. L'un de ces deux événements peut être déclenché sur l'élément cible lorsque Mouse.PreviewMouseUp 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 OnPreviewMouseUp, vous indiquez de façon explicite que votre gestion de classe s'est chargée de toutes les actions relatives aux relâchements 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 pas d'implémentation par défaut. Dans la mesure où une classe intermédiaire de l'héritage peut 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 dans lequel la gestion de classe est particulièrement appropriée est la manipulation des données d'événement et le marquage de 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

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

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