PresentationSource.AddSourceChangedHandler Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

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

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

handler

SourceChangedEventHandler

Implementacja programu obsługi do dodania.

Uwagi

Pomimo tego, jaki jest blok składni dla tego zdarzenia, nie ma uzasadnionego użycia właściwości dołączonych języka znaczników aplikacji (XAML). Nie należy próbować dodawać programów obsługi w języku XAML (Extensible Application Markup Language) i 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łączane tylko podczas inicjowania obiektu i powinny zostać jawnie usunięte w metodzie Dispose lub w równoważnym czyszczeniu obiektu.

Mimo że jest to zdarzenie kierowane, istnieją specjalne ograniczenia nałożone na to zdarzenie, które różnią się od normalnego zachowania zdarzeń kierowanych, ze względu na stosunkowo małą liczbę elementów w typowym scenariuszu aplikacji, które będą dotyczyć obsługi tego zdarzenia.

• Nie można użyć metod UIElement ani ContentElementAddHandler do dodawania procedur obsługi. Należy użyć AddSourceChangedHandler.

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

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

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