FrameworkContentElement.OnPropertyChanged Método

Definição

Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto FrameworkContentElement for atualizado. A propriedade específica de dependência que mudou é reportada no parâmetro de argumentos. Anula 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)

Parâmetros

e
DependencyPropertyChangedEventArgs

Os dados de eventos que descrevem a propriedade que mudou, incluindo os valores antigo e novo.

Observações

Este método não se destina geralmente a detetar alterações ou invalidações de propriedades. Destina-se, em vez disso, a modificações do padrão geral de invalidação se certas informações forem conhecidas sobre classificações amplas de propriedades.

Este método é potencialmente invocado muitas vezes ao longo da vida de um objeto. Assim, pode obter melhor desempenho se sobrescrever os metadados de propriedades específicas e depois anexar CoerceValueCallback funções de ou PropertyChangedCallback para propriedades individuais. No entanto, usaria este método se a FrameworkContentElement incluir um número significativo de propriedades de dependência inter-relacionadas com valor, ou se incluir lógica como comportamento de renderização que deve ser repetido para vários casos relacionados de invalidação de propriedades.

Note que existe um método com OnPropertyChanged nome idêntico e assinatura diferente (o tipo de parâmetro é PropertyChangedEventArgs) que pode aparecer em várias classes. Este OnPropertyChanged é usado para notificações de objetos de dados e faz parte do contrato para INotifyPropertyChanged.

Notas para Herdeiros

Chame sempre a implementação base como a primeira operação da sua implementação. A falha em fazer isto irá desabilitar significativamente todo o sistema de propriedades WPF, o que faz com que valores incorretos sejam reportados.

Aplica-se a

Ver também