RoutedEventHandler RoutedEventHandler RoutedEventHandler RoutedEventHandler Delegate

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 Object Object Object

Objet où le gestionnaire d’événements est attaché.The object where the event handler is attached.

e
RoutedEventArgs RoutedEventArgs RoutedEventArgs RoutedEventArgs

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

Héritage
RoutedEventHandlerRoutedEventHandlerRoutedEventHandlerRoutedEventHandler

Remarques

Le RoutedEventHandler délégué est utilisé pour tout événement routé qui ne signale pas les informations spécifiques aux événements 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 nombreuses ces événements routés ; incluent des exemples évidents 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é par opposition à un grand Common Language Runtime (CLR)common language runtime (CLR) événement est que le sender de l’événement (l’élément où le gestionnaire est attaché et appelé) ne peut pas être considérées comme nécessairement 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)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 signalé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). Une différence entre sender et Source est le résultat de l’événement qui est routé vers différents éléments, pendant le parcours 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 un objet référence si vous n’êtes pas délibérément le comportement de routage d’un événement routé direct ou de propagation et vous souhaitez uniquement gérer les événements routés sur les éléments dans lequel ils sont déclenchés en premier.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 correspondent au même objet.In this circumstance, sender and Source are the same object.

Si vous ne souhaitez pas 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 que vous utiliserez 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 WPFWPF classes de contrôle, l’élément qui déclenche l’événement n’est pas le premier élément qui a l’opportunité de le gérer.For certain combinations of input events and WPFWPF 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 version préliminaire de l’événement, la racine de l’arborescence d’éléments a la première opportunité, Handled à true dans les données d’événement partagé et peut influencer la manière dont l’événement d’entrée est signalée pour les é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. La version préliminaire de comportement de gestion peut donner l’impression 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 événements Preview et vue d’ensemble de l’entrée.For more information, see Preview Events and Input Overview.

Méthodes d’extension

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) 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 à