PresentationSource.AddSourceChangedHandler Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt dem bereitgestellten Element einen Handler für das SourceChanged-Ereignis hinzu.
public:
static void AddSourceChangedHandler(System::Windows::IInputElement ^ element, System::Windows::SourceChangedEventHandler ^ handler);[System.Security.SecurityCritical]
public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);[<System.Security.SecurityCritical>]
static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unitstatic member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unitPublic Shared Sub AddSourceChangedHandler (element As IInputElement, handler As SourceChangedEventHandler)Parameter
- element
- IInputElement
Das Element, dem der Handler hinzugefügt werden soll.
- handler
- SourceChangedEventHandler
Die hinzuzufügende Handlerimplementierung.
- Attribute
Hinweise
Obwohl der Syntaxblock für dieses Ereignis zu verstehen ist, gibt es keine legitime verwendung von angefügten XAML-Eigenschaften (Extensible Application Markup Language). Sie sollten nicht versuchen, Handler in XAML (Extensible Application Markup Language) hinzuzufügen, und Handler im Code sollten nur für Objekte platziert werden, die als Hosts für Präsentationsinhalte (PresentationSource) dienen. Solche Handler sollten nur während der Objektinitialisierung angefügt werden und in einer Dispose-Methode oder einer entsprechenden Objektbereinigung explizit entfernt werden.
Obwohl dies ein Routingereignis ist, gelten spezielle Einschränkungen für dieses Ereignis, die sich vom normalen Routingereignisverhalten unterscheiden, aufgrund der relativ geringen Anzahl von Elementen in einem typischen Anwendungsszenario, das sich mit der Behandlung dieses Ereignisses befassen würde.
Sie können die methoden UIElement oder ContentElementAddHandler nicht verwenden, um Handler hinzuzufügen. Sie müssen AddSourceChangedHandlerverwenden.
Die C#-
+=- und-=-Ereignishandlersyntaxen und zugehörige sprachspezifische Handlersyntaxen werden nicht unterstützt, da das Ereignis selbst nicht als öffentlich verfügbar gemacht wird. Nur die PresentationSource Hilfsmethoden zum direkten Hinzufügen und Entfernen der Handler werden unterstützt.Klassenhandler sind nicht zulässig. Insbesondere können Sie RegisterClassHandler nicht für dieses Ereignis in einem Klassenkonstruktor aufrufen, da obwohl ein Bezeichnerfeld für SourceChanged vorhanden ist, der Bezeichner nicht öffentlich ist.
Alle registrierten Handler erhalten das SourceChanged-Ereignis, auch wenn einer der Handler versucht, die Argumente als behandelt zu markieren.
