PresentationSource.AddSourceChangedHandler Metod

Definition

Namnområde:
System.Windows
Sammansättning:
PresentationCore.dll

Lägger till en hanterare för SourceChanged händelsen i det angivna elementet.

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)

Parametrar

element
IInputElement

Elementet som hanteraren ska läggas till i.

handler
SourceChangedEventHandler

Den hanteringsimplementering som ska läggas till.

Attribut
SecurityCriticalAttribute

Kommentarer

Trots vad syntaxblocket för den här händelsen säger finns det ingen legitim XAML-kopplad egenskapsanvändning (Extensible Application Markup Language). Du bör inte försöka lägga till hanterare i XAML (Extensible Application Markup Language) och hanterare i kod bör endast placeras på objekt som fungerar som värdar för presentation (PresentationSource ) innehåll. Sådana hanterare bör endast kopplas under objektinitiering och bör uttryckligen tas bort i en rensningsmetod eller motsvarande objektrensning.

Även om det här är en dirigerad händelse finns det särskilda begränsningar för den här händelsen som skiljer sig från normalt beteende för routade händelser, på grund av det relativt lilla antalet element i ett typiskt programscenario som skulle bekymra sig om att hantera den här händelsen.

  • Du kan inte använda UIElement metoderna eller ContentElementAddHandler för att lägga till hanterare. Du måste använda AddSourceChangedHandler.

  • Syntaxerna för C# += och -= händelsehanteraren och relaterade språkspecifika hanterarsyntaxer stöds inte eftersom själva händelsen inte exponeras som offentlig. Endast verktygsmetoderna PresentationSource för att lägga till och ta bort hanterarna direkt stöds.

  • Klasshanterare tillåts inte. Mer specifikt kan du inte anropa RegisterClassHandler mot den här händelsen i en klasskonstruktor eftersom även om det finns ett identifierarfält för SourceChanged är identifieraren inte offentlig.

  • Alla registrerade hanterare får händelsen SourceChanged även om någon av hanterarna försöker markera argumenten som hanterade.

Gäller för