FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) 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 FrameworkElement 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 -> unitProtected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parâmetros
Os dados de eventos que descrevem a propriedade que mudou, bem como valores antigos e novos.
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 FrameworkElement 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. A implementação específica FrameworkElement é também responsável por manter o estado correto para várias propriedades que afetam a interface de utilizador visível. Estas incluem invalidar a árvore visual com base em alterações de estilo em momentos apropriados.
