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.Represents the method that will handle various routed events that do not have specific event data beyond the data that is common for all routed events.

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é.The object where the event handler is attached.

e
RoutedEventArgs

Données d'événement.The event data.

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.The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. Il existe de nombreux événements routés de ce type ; les exemples évidents incluent Click et Loaded .There are many such routed events; prominent examples include Click and Loaded.

La différence la plus notable entre l’écriture d’un gestionnaire pour un événement routé et l’événement général common language runtime (CLR) 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 la source de l’événement.The most noteworthy difference between writing a handler for a routed event as opposed to a general common language runtime (CLR) event is that the sender of the event (the element where the handler is attached and invoked) cannot be considered to necessarily be the source of the event. La source est indiquée en tant que propriété dans les données d’événement ( Source ).The source is reported as a property in the event data (Source). La différence entre sender et Source est le résultat de l’événement qui est routé vers différents éléments, pendant la traversée de l’événement routé via une arborescence d’éléments.A difference between sender and Source is the result of the event being routed to different elements, during the traversal of the routed event through an element tree.

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 de propagation et que vous envisagez de gérer des événements routés uniquement sur les éléments où ils sont déclenchés pour la première fois.You can use either sender or Source for an object reference if you are deliberately not interested in the routing behavior of a direct or bubbling routed event and you only intend to handle routed events on the elements where they are first raised. Dans ce cas, sender et Source sont le même objet.In this circumstance, sender and Source are the same object.

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 que vous allez utiliser lors de l’écriture de gestionnaires d’événements sont Source et Handled .If you do intend to take advantage of the inherent features of routed events and write your handlers accordingly, the two most important properties of the event data that you will work with when writing event handlers are Source and Handled.

Pour certaines combinaisons d’événements d’entrée et de classes de contrôles 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.For certain combinations of input events and WPF control classes, the element that raises the event is not the first element that has the opportunity to handle it. Si l’événement d’entrée a une préversion de l’événement, la racine de l’arborescence des éléments a la première opportunité, peut avoir la valeur Handled true dans les données d’événement partagé 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.If the input event has a Preview version of the event, then the root of the element tree has first opportunity, can set Handled to true in the shared event data, and can influence how the input event is reported to remaining elements in its event route. Le comportement de gestion de l’aperçu peut indiquer qu’un événement routé particulier n’est pas déclenché comme prévu.The Preview handling behavior can give the appearance that a particular routed event is not raised as expected. Pour plus d’informations, consultez aperçu des événements et de l' entrée.For more information, see Preview Events and Input Overview.

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é.Gets an object that represents the method represented by the specified delegate.

S’applique à