PresentationSource.AddSourceChangedHandler Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Přidá obslužnou rutinu události SourceChanged do poskytnutého prvku.

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)

Parametry

element

IInputElement

Element pro přidání obslužné rutiny do.

handler

SourceChangedEventHandler

Implementace obslužné rutiny, která se má přidat.

Poznámky

Bez ohledu na to, co blok syntaxe pro tuto událost uvádí, neexistuje žádné legitimní použití připojených vlastností jazyka XAML (Extensible Application Markup Language). Neměli byste se pokoušet přidávat obslužné rutiny v jazyce XAML (Extensible Application Markup Language) a obslužné rutiny v kódu by měly být umístěny pouze na objekty, které slouží jako hostitelé pro obsah prezentace (PresentationSource). Tyto obslužné rutiny by měly být připojeny pouze během inicializace objektů a měly by být explicitně odebrány v metodě Dispose nebo ekvivalentní vyčištění objektu.

I když se jedná o směrovanou událost, existují zvláštní omezení pro tuto událost, která se liší od normálního směrovaného chování události, protože relativně malý počet prvků v typickém scénáři aplikace, které by se mohly zabývat zpracováním této události.

• K přidání obslužných rutin nelze použít UIElement nebo ContentElementAddHandler metody. Je nutné použít AddSourceChangedHandler.

• Syntaxe obslužné rutiny událostí jazyka C# += a -= a související syntaxe obslužné rutiny specifické pro jazyk se nepodporují, protože samotná událost není zpřístupněna jako veřejná. Podporují se pouze PresentationSource utility metody pro přidání a odebrání obslužných rutin přímo.

• Obslužné rutiny tříd nejsou povoleny. Konkrétně nelze volat RegisterClassHandler proti této události v konstruktoru třídy, protože ačkoli pole identifikátoru existuje pro SourceChanged, identifikátor není veřejný.

• Všechny registrované obslužné rutiny obdrží událost SourceChanged, i když se některý z obslužných rutin pokusí označit argumenty jako zpracovávané.