RoutedEventHandler Délégué

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Représente la méthode qui gère différents événements routés qui n’ont pas de données d’événements spécifiques au-delà des données courantes pour 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 dans lequel 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 ; les exemples 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 l’événement sender (l’élément où le gestionnaire est attaché et appelé) ne peut pas nécessairement être considéré comme 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 une référence d’objet 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 en bouchant et que vous envisagez uniquement de gérer les événements routés sur les éléments où ils sont déclenchés pour la première fois. Dans ce cas, sender et Source sont le même objet.

Si vous envisagez de tirer parti des fonctionnalités inhérentes des é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 avec lesquelles vous allez travailler 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 version preview de l’événement, la racine de l’arborescence d’éléments a la première opportunité, peut être définie Handledtrue sur 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 la préversion peut donner l’apparence 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 de l’entrée.