PresentationSource.AddSourceChangedHandler Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

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);

public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);

static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit

Public 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.

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.