FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda

Definice

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

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, která popisuje vlastnost, která se změnila, a také 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 ke změnám obecného vzoru zneplatnění, pokud jsou známy určité informace o široké klasifikaci 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 funkce nebo PropertyChangedCallback pro jednotlivé vlastnosti. Tuto metodu byste však použili, pokud FrameworkElement obsahuje významný počet vlastností závislostí, které jsou vzájemně propojené 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 identicky pojmenovaná OnPropertyChanged metoda s jiným podpisem (typ parametru je PropertyChangedEventArgs), která se může objevit v řadě tříd. Používá se OnPropertyChanged pro oznámení datových objektů a je součástí kontraktu 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, což způsobí hlášení nesprávných hodnot. Konkrétní FrameworkElement implementace je také zodpovědná za udržování správného stavu různých vlastností, které ovlivňují viditelné uživatelské rozhraní. Patří mezi ně zrušení platnosti vizuálního stromu na základě změn stylu ve vhodných časech.

Platí pro

Viz také