PresentationSource.AddSourceChangedHandler Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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.