FrameworkContentElement.OnPropertyChanged Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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.