Sdílet prostřednictvím

PresentationSource.AddSourceChangedHandler Metoda

  • Reference

Definice

Obor názvů:
System.Windows
Sestavení:
PresentationCore.dll

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

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)

Parametry

element
IInputElement

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

handler
SourceChangedEventHandler

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

Atributy
SecurityCriticalAttribute

Poznámky

Navzdory tomu, co blok syntaxe pro tuto událost uvádí, neexistuje žádné legitimní použití vlastnosti 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ím 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 chování směrované 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.

  • Nelze použít UIElement metody nebo ContentElement AddHandler metody pro přidání obslužných rutin. Musíte použít AddSourceChangedHandler.

  • Syntaxe obslužné rutiny C# += a -= obslužné rutiny událostí a související syntaxe obslužné rutiny specifické pro jazyk nejsou podporovány, protože samotná událost není vystavena jako veřejná. PresentationSource Podporují se pouze metody nástroje pro přidávání a odebírá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 i když 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é.

Platí pro