RoutedEventHandler Delegat

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Stellt die Methode dar, die verschiedene Routingereignisse verarbeitet, die keine speziellen Daten über die Daten hinaus haben, die es für alle Routingereignisse gibt.

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 solcher Routingereignisse; prominente Beispiele sind Click und Loaded.

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

Sie können entweder sender oder Source für einen Objektverweis verwenden, wenn Sie absichtlich nicht am Routingverhalten eines direkten oder sprudelnden Routingereignisses interessiert sind und nur Routingereignisse für die Elemente behandeln möchten, an denen sie zuerst ausgelöst werden. In diesem Fall sender sind und Source dasselbe Objekt.

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

Für bestimmte 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 auf true festlegen Handled und beeinflussen, wie das Eingabeereignis an die verbleibenden Elemente in seiner Ereignisroute gemeldet wird. Das Verhalten der Vorschaubehandlung kann den Anschein erwecken, dass ein bestimmtes Routingereignis nicht wie erwartet ausgelöst wird. Weitere Informationen finden Sie unter Vorschauereignisse und Eingabeübersicht.

Erweiterungsmethoden