RoutedEventHandler Delegate

Definition

Stellt die Methode dar, die verschiedene Routingereignisse verarbeitet, die keine speziellen Daten über die Daten hinaus haben, die es für alle Routingereignisse gibt.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)

Parameters

sender
Object

Das Objekt, an das der Ereignishandler angefügt ist.The object where the event handler is attached.

e
RoutedEventArgs

Die Ereignisdaten.The event data.

Inheritance
RoutedEventHandler

Remarks

Der RoutedEventHandler-Delegat wird für alle Routing Ereignisse verwendet, die keine ereignisspezifischen Informationen in den Ereignisdaten melden.The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. Es gibt viele solche Routing Ereignisse. zu den wichtigsten Beispielen zählen Click und Loaded.There are many such routed events; prominent examples include Click and Loaded.

Der offensichtlichste Unterschied zwischen dem Schreiben eines Handlers für ein Routing Ereignis im Gegensatz zu einem allgemeinen Common Language Runtime (CLR)common language runtime (CLR) Ereignis besteht darin, dass die sender des Ereignisses (das Element, an das der Handler angefügt und aufgerufen wird) nicht als Quelle des Ereignisses betrachtet werden kann.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. Die Quelle wird als Eigenschaft in den Ereignisdaten (Source) gemeldet.The source is reported as a property in the event data (Source). Ein Unterschied zwischen sender und Source ist das Ergebnis des-Ereignisses, das während der Durchquerung des Routing Ereignisses durch eine Elementstruktur an verschiedene Elemente weitergeleitet wird.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.

Sie können entweder sender oder Source für einen Objekt Verweis verwenden, wenn Sie absichtlich nicht an dem Routing Verhalten eines direkten oder bubblindereignis interessiert sind und Sie nur Routing Ereignisse für die Elemente verarbeiten möchten, in denen Sie zuerst ausgelöst werden.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. In diesem Fall sind sender und Source das gleiche Objekt.In this circumstance, sender and Source are the same object.

Wenn Sie beabsichtigen, die inhärenten Features von gerouteten Ereignissen zu nutzen und die Handler entsprechend zu schreiben, werden die zwei wichtigsten Eigenschaften der Ereignisdaten, mit denen Sie beim Schreiben von Ereignis Handlern arbeiten, Source und 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.

Bei bestimmten Kombinationen von Eingabe Ereignissen und WPFWPF-Steuerelement Klassen ist das Element, das das Ereignis auslöst, nicht das erste Element, das die Möglichkeit hat, es zu verarbeiten.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. Wenn das Eingabe Ereignis eine Vorschauversion des Ereignisses aufweist, hat der Stamm der Elementstruktur die erste Gelegenheit, kann Handled auf true in den freigegebenen Ereignisdaten festlegen und beeinflussen, wie das Eingabe Ereignis den verbleibenden Elementen in der Ereignis Route gemeldet wird.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. Das Verhalten der Vorschau Behandlung kann die Darstellung eines bestimmten Routing Ereignisses als erwartungsgemäß anzeigen.The Preview handling behavior can give the appearance that a particular routed event is not raised as expected. Weitere Informationen finden Sie unter Vorschau Ereignisse und Eingabe Übersicht.For more information, see Preview Events and Input Overview.

Extension Methods

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Applies to