PresentationSource.AddSourceChangedHandler Methode

Definitie

Naamruimte:

System.Windows

Assembly:

PresentationCore.dll

Hiermee voegt u een handler voor de SourceChanged gebeurtenis toe aan het opgegeven element.

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)

Parameters

element

IInputElement

Het element waaraan de handler moet worden toegevoegd.

handler

SourceChangedEventHandler

De handler-implementatie die moet worden toegevoegd.

Opmerkingen

Ondanks wat het syntaxisblok voor deze gebeurtenis aangeeft, is er geen legitiem gebruik van aan XAML (Extensible Application Markup Language) gekoppelde eigenschappen. Probeer geen handlers toe te voegen in Extensible Application Markup Language (XAML) en handlers in code mogen alleen worden geplaatst op objecten die fungeren als hosts voor presentatieinhoud (PresentationSource ) . Dergelijke handlers mogen alleen worden gekoppeld tijdens het initialiseren van objecten en moeten expliciet worden verwijderd in een verwijderingsmethode of gelijkwaardige objectopruiming.

Hoewel dit een gerouteerde gebeurtenis is, zijn er speciale beperkingen voor deze gebeurtenis die verschillen van het normale gedrag van gerouteerde gebeurtenissen, vanwege het relatief kleine aantal elementen in een typisch toepassingsscenario dat zich bezig zou houden met het afhandelen van deze gebeurtenis.

• U kunt de UIElement of ContentElementAddHandler methoden niet gebruiken om handlers toe te voegen. Je moet AddSourceChangedHandler gebruiken.

• De syntaxis van de C# += - en -= gebeurtenis-handler en gerelateerde taalspecifieke handler worden niet ondersteund, omdat de gebeurtenis zelf niet als openbaar wordt weergegeven. Alleen de hulpprogrammamethoden voor het PresentationSource rechtstreeks toevoegen en verwijderen van de handlers worden ondersteund.

• Klasse-handlers zijn niet toegestaan. U kunt deze gebeurtenis niet aanroepen RegisterClassHandler in een klasseconstructor, omdat hoewel er een id-veld bestaat voor SourceChanged, de id niet openbaar is.

• Alle geregistreerde handlers ontvangen de gebeurtenis SourceChanged, zelfs als een van de handlers de argumenten als verwerkt probeert te markeren.