PresentationSource.AddSourceChangedHandler Methode

  • Referenz

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);
[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 -> unit
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 Implementierung des Handlers, die hinzugefügt werden soll.

Attribute
SecurityCriticalAttribute

Hinweise

Trotz des Syntaxblocks für dieses Ereignis gibt es keine legitime Extensible Application Markup Language (XAML) angefügte Eigenschaftsnutzung. Sie sollten nicht versuchen, Handler in Extensible Application Markup Language (XAML) hinzuzufügen, und Handler in Code sollten nur auf Objekten platziert werden, die als Hosts für Präsentationsinhalte (PresentationSource ) dienen. Solche Handler sollten nur während der Objekt initialisierung angefügt werden und in einer Dispose-Methode oder einer entsprechenden Objektbereinigung explizit entfernt werden.

Obwohl dies ein weitergeleitetes Ereignis ist, gibt es spezielle Einschränkungen für dieses Ereignis, die sich von einem normalen Routingereignisverhalten unterscheiden, aufgrund der relativ kleinen Anzahl von Elementen in einem typischen Anwendungsszenario, das sich mit der Behandlung dieses Ereignisses befassen würde.

  • Sie können die UIElement ContentElement AddHandler Methoden nicht verwenden, um Handler hinzuzufügen. Hierzu muss AddSourceChangedHandler verwendet werden.

  • Die Syntax von C# += und Ereignishandlern und -= verwandte sprachspezifische Handlersyntaxen wird nicht unterstützt, da das Ereignis selbst nicht als öffentlich verfügbar gemacht wird. Nur die PresentationSource Hilfsmethoden zum Hinzufügen und Entfernen der Handler werden direkt unterstützt.

  • Klassenhandler sind nicht zulässig. Insbesondere können Sie dieses Ereignis in einem Klassenkonstruktor nicht aufrufen RegisterClassHandler , da ein Bezeichnerfeld für SourceChanged vorhanden ist, ist der Bezeichner nicht öffentlich.

  • Alle registrierten Handler erhalten das SourceChanged-Ereignis auch dann, wenn eine der Handler versucht, die Argumente als behandelt zu markieren.

Gilt für