FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Método

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse FrameworkElement for atualizado. A propriedade de dependência específica alterada é relatada no parâmetro de argumentos. Substitui 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 evento que descrevem a propriedade alterada, bem como valores novos e antigos.

Comentários

Esse método não se destina a detectar alterações ou invalidações de propriedade em geral. Em vez disso, destina-se a modificações do padrão de invalidação geral se determinadas informações forem conhecidas sobre classificações amplas de propriedades.

Esse método é potencialmente invocado muitas vezes durante a vida útil de um objeto. Portanto, você poderá obter um melhor desempenho se substituir os metadados de propriedades específicas e anexar CoerceValueCallback ou PropertyChangedCallback funções para propriedades individuais. No entanto, você usaria esse método se inclua um FrameworkElement número significativo de propriedades de dependência interrelacionadas por valor ou se ele inclua lógica como comportamento de renderização que deve ser executado novamente para vários casos relacionados de invalidações de propriedade.

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

Notas aos Herdeiros

Sempre chame a implementação base, como a primeira operação em sua implementação. A falha em fazer isso desabilitará significativamente todo o sistema de propriedades do WPF, o que faz com que valores incorretos sejam relatados. A implementação específica FrameworkElement também é responsável por manter o estado adequado para uma variedade de propriedades que afetam a interface do usuário visível. Isso inclui invalidar a árvore visual com base em alterações no estilo em horários apropriados.

Aplica-se a