FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metodo

Definizione

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in FrameworkElement. La proprietà di dipendenza specifica modificata viene indicata nel parametro degli argomenti. Esegue l'override di 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)

Parametri

e
DependencyPropertyChangedEventArgs

Dati dell'evento che descrivono la proprietà modificata, nonché i valori vecchio e nuovo.

Commenti

Questo metodo non è destinato a rilevare in genere le modifiche delle proprietà o le invalidazioni. È invece destinato alle modifiche del modello generale di invalidazione se alcune informazioni sono note sulle classificazioni wide delle proprietà.

Questo metodo viene potenzialmente richiamato molte volte durante la vita di un oggetto. Pertanto, è possibile ottenere prestazioni migliori se si esegue l'override dei metadati di proprietà specifiche e quindi collegare CoerceValueCallback o PropertyChangedCallback funzioni per le singole proprietà. Tuttavia, si userebbe questo metodo se un FrameworkElement include un numero significativo di proprietà di dipendenza correlate a valori o se include logica, ad esempio il comportamento di rendering che deve essere eseguito di nuovo per diversi casi correlati di invalidazioni delle proprietà.

Si noti che esiste un metodo denominato OnPropertyChanged identico con una firma diversa (il tipo di parametro è PropertyChangedEventArgs) che può essere visualizzato in un numero di classi. Utilizzato OnPropertyChanged per le notifiche dell'oggetto dati e fa parte del contratto per INotifyPropertyChanged.

Note per gli eredi

Chiamare sempre l'implementazione di base, come prima operazione nell'implementazione. Non è possibile eseguire questa operazione disabilitando significativamente l'intero sistema di proprietà WPF, che causa la segnalazione di valori non corretti. L'implementazione specifica FrameworkElement è anche responsabile del mantenimento dello stato appropriato per un'ampia gamma di proprietà che influiscono sull'interfaccia utente visibile. Questi includono l'invalidazione dell'albero visivo in base alle modifiche apportate allo stile in momenti appropriati.

Si applica a

Vedi anche