FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Méthode

Définition

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce FrameworkElement a été mise à jour. La propriété de dépendance spécifique qui a changé est indiquée dans le paramètre d’arguments. Substitue 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)

Paramètres

e
DependencyPropertyChangedEventArgs

Données d’événement qui décrivent la propriété qui a changé, ainsi que les anciennes et nouvelles valeurs.

Remarques

Cette méthode n’est pas destinée à détecter généralement les modifications de propriété ou les invalidations. Il est plutôt destiné aux modifications du modèle d’invalidation général si certaines informations sont connues sur les classifications étendues des propriétés.

Cette méthode est potentiellement appelée plusieurs fois pendant la durée de vie d’un objet. Par conséquent, vous pouvez obtenir de meilleures performances si vous remplacez les métadonnées de propriétés spécifiques, puis si vous attachez CoerceValueCallback ou PropertyChangedCallback des fonctions pour des propriétés individuelles. Toutefois, vous utiliserez cette méthode si un FrameworkElement inclut un nombre important de propriétés de dépendance liées entre des valeurs, ou s’il inclut une logique telle que le comportement de rendu qui doit être réexécuté pour plusieurs cas connexes d’invalidations de propriété.

Notez qu’il existe une méthode nommée OnPropertyChanged identiquement avec une signature différente (le type de paramètre est PropertyChangedEventArgs) qui peut apparaître sur un certain nombre de classes. Utilisé OnPropertyChanged pour les notifications d’objets de données, il fait partie du contrat pour INotifyPropertyChanged.

Notes pour les héritiers

Appelez toujours l’implémentation de base, comme première opération de votre implémentation. Si vous ne le faites pas, l’ensemble du système de propriétés WPF est considérablement désactivé, ce qui entraîne la signalement de valeurs incorrectes. L’implémentation spécifique FrameworkElement est également responsable du maintien d’un état correct pour une variété de propriétés qui affectent l’interface utilisateur visible. Il s’agit notamment de l’invalidation de l’arborescence visuelle en fonction des modifications apportées au style à des moments appropriés.

S’applique à

Voir aussi