Jazyk

FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda

Definice

Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této FrameworkElement vlastnosti. Konkrétní vlastnost závislosti, která se změnila, je hlášena v parametru argumentů. Přepíše OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected override void OnPropertyChanged(System.Windows.DependencyPropertyChangedEventArgs e);
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parametry

e
DependencyPropertyChangedEventArgs

Data události popisují vlastnost, která se změnila, stejně jako staré a nové hodnoty.

Poznámky

Tato metoda není určena k obecné detekci změn vlastností nebo zneplatnění. Místo toho je určena k úpravám obecného vzoru zneplatnění, pokud jsou určité informace známé o širokých klasifikacích vlastností.

Tato metoda je potenciálně vyvolána mnohokrát během životnosti objektu. Proto můžete dosáhnout lepšího výkonu, pokud přepíšete metadata konkrétních vlastností a pak připojíte CoerceValueCallback nebo PropertyChangedCallback funkce pro jednotlivé vlastnosti. Tuto metodu byste však použili v případě FrameworkElement , že zahrnuje významný počet vlastností závislostí souvisejících s hodnotou nebo pokud obsahuje logiku, jako je chování vykreslování, které je nutné znovu spustit pro několik souvisejících případů zneplatnění vlastností.

Všimněte si, že existuje identická pojmenovaná OnPropertyChanged metoda s jiným podpisem (typ parametru), PropertyChangedEventArgskterá se může objevit v řadě tříd. Používá se OnPropertyChanged pro oznámení datového objektu a je součástí smlouvy pro INotifyPropertyChanged.

Poznámky pro dědice

Jako první operaci v implementaci vždy volejte základní implementaci. Pokud to neuděláte, výrazně se zakáže celý systém vlastností WPF (Windows Presentation Foundation), což způsobí nahlášení nesprávných hodnot. Konkrétní FrameworkElement implementace je také zodpovědná za udržování správného stavu pro řadu vlastností, které ovlivňují viditelné uživatelské rozhraní. Patří mezi ně zneplatnění stromu vizuálu na základě změn stylu v odpovídajících časech.

Platí pro

Viz také