PresentationSource.AddSourceChangedHandler Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationCore.dll

Dodaje procedurę obsługi dla SourceChanged zdarzenia do podanego elementu.

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, do który ma zostać dodany program obsługi.

handler
SourceChangedEventHandler

Implementacja procedury obsługi do dodania.

Atrybuty
SecurityCriticalAttribute

Uwagi

Pomimo tego, jaki jest blok składni dla tego zdarzenia, nie ma uzasadnionego użycia właściwości języka XAML (Extensible Application Markup Language). Nie należy próbować dodawać programów obsługi w języku Extensible Application Markup Language (XAML), a programy obsługi w kodzie powinny być umieszczane tylko na obiektach, które służą jako hosty do prezentacji (PresentationSource ) zawartości. Takie procedury obsługi powinny być dołączone tylko podczas inicjowania obiektu i powinny zostać jawnie usunięte w metodzie Dispose lub równoważnym oczyszczeniu obiektu.

Mimo że jest to zdarzenie kierowane, istnieją specjalne ograniczenia wprowadzone w tym zdarzeniu, które różnią się od normalnego zachowania zdarzeń kierowanych, ze względu na stosunkowo niewielką liczbę elementów w typowym scenariuszu aplikacji, które dotyczyłyby obsługi tego zdarzenia.

  • Nie można użyć UIElement metod lub ContentElement AddHandler do dodawania programów obsługi. Musisz użyć polecenia AddSourceChangedHandler.

  • Składnie języka C# += i -= procedury obsługi zdarzeń i powiązane składnie programu obsługi specyficzne dla języka nie są obsługiwane, ponieważ samo zdarzenie nie jest widoczne jako publiczne. PresentationSource Obsługiwane są tylko metody narzędzi do dodawania i usuwania programów obsługi bezpośrednio.

  • Programy obsługi klas nie są dozwolone. W szczególności nie można wywołać tego RegisterClassHandler zdarzenia w konstruktorze klasy, ponieważ chociaż pole identyfikatora istnieje dla metody SourceChanged, identyfikator nie jest publiczny.

  • Wszystkie zarejestrowane programy obsługi otrzymają zdarzenie SourceChanged, nawet jeśli jedna z procedur obsługi próbuje oznaczyć argumenty jako obsługiwane.

Dotyczy