RoutedEventHandler Delegat

Definition

Stellt die Methode dar, die verschiedene Routingereignisse behandelt, die keine spezifischen Ereignisdaten über die Daten hinaus aufweisen, die für alle Routingereignisse gemeinsam sind.

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)

Parameter

sender
Object

Das Objekt, an das der Ereignishandler angefügt ist.

e
RoutedEventArgs

Die Ereignisdaten.

Hinweise

Der RoutedEventHandler Delegat wird für jedes Routingereignis verwendet, das keine ereignisspezifischen Informationen in den Ereignisdaten meldet. Es gibt viele solche Routingereignisse; Zu den prominenten Beispielen gehören Click und Loaded.

Der bemerkenswerteste Unterschied zwischen dem Schreiben eines Handlers für ein routingfähiges Ereignis im Gegensatz zu einem allgemeinen CLR-Ereignis (Common Language Runtime) besteht darin, dass das sender Ereignis (das Element, an das der Handler angefügt und aufgerufen wird) nicht unbedingt als Quelle des Ereignisses betrachtet werden kann. Die Quelle wird als Eigenschaft in den Ereignisdaten (Source) gemeldet. Ein Unterschied zwischen sender und Source dem Ergebnis, dass das Ereignis an verschiedene Elemente weitergeleitet wird, während der Durchquerung des Routingereignisses durch eine Elementstruktur.

Sie können entweder sender oder Source für einen Objektverweis verwenden, wenn Sie bewusst nicht an dem Routingverhalten eines direct- oder bubbling-routinggesteuerten Ereignisses interessiert sind und nur Routingereignisse für die Elemente behandeln möchten, in denen sie zuerst ausgelöst werden. In diesem Fall sender und Source sind dasselbe Objekt.

Wenn Sie beabsichtigen, die inhärenten Features von Routingereignissen zu nutzen und die Handler entsprechend zu schreiben, sind die beiden wichtigsten Eigenschaften der Ereignisdaten, mit denen Sie beim Schreiben von Ereignishandlern Source arbeiten werden, und Handled.

Bei bestimmten Kombinationen von Eingabeereignissen und WPF Steuerelementklassen ist das Element, das das Ereignis auslöst, nicht das erste Element, das die Möglichkeit hat, es zu behandeln. Wenn das Eingabeereignis über eine Vorschauversion des Ereignisses verfügt, hat der Stamm der Elementstruktur die erste Gelegenheit, kann in den freigegebenen Ereignisdaten festgelegt Handledtrue werden und kann beeinflussen, wie das Eingabeereignis den verbleibenden Elementen in der Ereignisroute gemeldet wird. Das Verhalten der Vorschaubehandlung kann das Erscheinungsbild vermitteln, dass ein bestimmtes Routingereignis nicht wie erwartet ausgelöst wird. Weitere Informationen finden Sie unter Vorschauereignisse und Eingabeübersicht.

Erweiterungsmethoden

Name Beschreibung
GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die vom angegebenen Delegaten dargestellte Methode darstellt.

Gilt für: