RoutedEventHandler Délégué

Définition

Représente la méthode chargée de gérer divers événements routés qui n’ont pas de données d’événement spécifiques en dehors des données communes à tous les événements routés.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);
public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);
type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit
Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

Paramètres

sender
Object

Objet où le gestionnaire d’événements est attaché.

e
RoutedEventArgs

Données d'événement.

Remarques

Le RoutedEventHandler délégué est utilisé pour tout événement routé qui ne signale pas d’informations spécifiques à l’événement dans les données d’événement. Il existe de nombreux événements routés de ce type ; les exemples les plus importants incluent Click et Loaded.

La différence la plus notable entre l’écriture d’un gestionnaire pour un événement routé par opposition à un événement CLR (Common Language Runtime) général est que le sender de l’événement (l’élément où le gestionnaire est attaché et appelé) ne peut pas être considéré comme nécessairement la source de l’événement. La source est signalée en tant que propriété dans les données d’événement (Source). Une différence entre sender et Source est le résultat de l’événement routé vers différents éléments, pendant la traversée de l’événement routé via une arborescence d’éléments.

Vous pouvez utiliser sender ou Source pour une référence d’objet si vous n’êtes délibérément pas intéressé par le comportement de routage d’un événement routé direct ou bouillonnant et que vous avez l’intention de gérer uniquement les événements routés sur les éléments où ils sont déclenchés pour la première fois. Dans cette circonstance, sender et Source sont le même objet.

Si vous envisagez de tirer parti des fonctionnalités inhérentes aux événements routés et d’écrire vos gestionnaires en conséquence, les deux propriétés les plus importantes des données d’événement que vous utiliserez 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 la possibilité de le gérer. Si l’événement d’entrée a une préversion de l’événement, la racine de l’arborescence d’éléments a la première opportunité, peut définir Handled sur true dans les données d’événement partagées et 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.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

S’applique à