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
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

RoutedEventHandler, délégué

Représente la méthode qui gérera différents événements routés qui n'ont pas de données d'événement spécifiques autres que les données qui sont communes pour tous les événements routés.

Espace de noms :  System.Windows
Assembly :  PresentationCore (dans PresentationCore.dll)
public delegate void RoutedEventHandler(
	Object sender,
	RoutedEventArgs e
)

Paramètres

sender
Type : System.Object
Objet auquel le gestionnaire d'événements est attaché.
e
Type : System.Windows.RoutedEventArgs
Données d'événement.

Le délégué RoutedEventHandler est utilisé pour tout événement routé qui n'enregistre pas d'informations spécifiques à l'événement dans les données d'événement. De tels événements sont très nombreux ; parmi les exemples évidents figurent Click et Loaded.

La différence la plus notable entre l'écriture d'un gestionnaire pour un événement routé et celui pour d'un événement Common Language Runtime (CLR) général est que le sender de l'événement (l'élément auquel le gestionnaire est attaché et sur lequel il est appelé) ne peut pas nécessairement être considéré comme la source de l'événement. La source est enregistrée comme une propriété dans les données d'événement (Source). Le résultat de l'événement qui est routé vers différents éléments, pendant la traversée d'une arborescence d'éléments par l'événement routé, constitue une différence entre sender et Source.

Vous pouvez utiliser sender ou Source comme référence pour un objet si vous ne vous intéressez pas de façon délibérée au comportement de routage d'un événement routé direct ou propagé et que vous projetez uniquement de gérer des événements routés sur les éléments sur lesquels ils sont déclenchés en premier. Dans ce cas, sender et Source sont le même objet.

Si vous souhaitez tirer parti des fonctionnalités inhérentes d'événements routés et écrire vos gestionnaires en conséquence, les deux propriétés les plus importantes des données d'événement avec lesquelles vous travaillerez lors de l'écriture de gestionnaires d'événements sont Source et Handled.

Pour certaines combinaisons d'événements d'entrée et de classes de contrôle WPF, l'élément qui déclenche l'événement n'est pas le premier élément qui a l'opportunité de le gérer. Si l'événement d'entrée a une version Aperçu de l'événement, la racine de l'arborescence des éléments a la première opportunité, elle peut affecter la valeur true à Handled dans les données d'événement partagées et elle peut influencer la façon dont l'événement d'entrée est signalé aux éléments restants dans son itinéraire d'événement. Le comportement de gestion de l'aperçu peut donner l'impression qu'un événement routé particulier n'est pas déclenché comme prévu. Pour plus d'informations, consultez Aperçu des événements et Vue d'ensemble des entrées.

Cet exemple montre comment rechercher l'élément source dans un gestionnaire d'événements.

L'exemple suivant présente un gestionnaire d'événements Click déclaré dans un fichier code-behind. Lorsqu'un utilisateur clique sur le bouton auquel est relié le gestionnaire, celui-ci modifie une valeur de propriété. Le code du gestionnaire utilise la propriété Source des données d'événement routées renseignée dans les arguments d'événement pour modifier la valeur de la propriété Width sur l'élément Source.


<Button Click="HandleClick">Button 1</Button>



Private Sub HandleClick(ByVal sender As Object, ByVal e As RoutedEventArgs)
    'You must cast the object as a Button element, or at least as FrameworkElement, to set Width
    Dim srcButton As Button
    srcButton = CType(e.Source, Button)
    srcButton.Width = 200
End Sub



        void HandleClick(object sender, RoutedEventArgs e)
        {
            // You must cast the sender object as a Button element, or at least as FrameworkElement, to set Width
            Button srcButton = e.Source as Button;
			srcButton.Width = 200;
        }


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.