PropertyDescriptor.ResetValue(Object) Méthode

Définition

En cas de substitution dans une classe dérivée, rétablit la valeur par défaut de cette propriété du composant.

public:
 abstract void ResetValue(System::Object ^ component);
public abstract void ResetValue (object component);
abstract member ResetValue : obj -> unit
Public MustOverride Sub ResetValue (component As Object)

Paramètres

component
Object

Composant dont la valeur par défaut de la propriété doit être rétablie.

Remarques

En règle générale, cette méthode est implémentée par réflexion.

Cette méthode détermine la valeur à laquelle réinitialiser la propriété dans l’ordre de priorité suivant :

  1. Il existe une propriété ombrée pour cette propriété.

  2. Il existe un DefaultValueAttribute pour cette propriété.

  3. Vous avez implémenté une méthode « ResetMyProperty », où « MyProperty » est le nom de la propriété que vous lui transmettez.

Cette méthode crée automatiquement un DesignerTransaction dans l’ordre suivant :

  1. La méthode appelle la IDesignerHost.CreateTransaction méthode pour créer un nouveau DesignerTransaction afin de représenter les modifications.

  2. La méthode appelle la IComponentChangeService.OnComponentChanging méthode pour indiquer que la transaction a commencé et que les modifications sont sur le point de se produire.

  3. La méthode réinitialise la propriété à la valeur déterminée par l’ordre de vérification de cette méthode.

  4. La méthode appelle la IComponentChangeService.OnComponentChanged méthode pour indiquer que les modifications ont eu lieu.

  5. La méthode appelle DesignerTransaction.Commit pour indiquer que la transaction est terminée.

L’objectif de la transaction est de prendre en charge Undo et Redo de fonctionnalités.

Notes pour les responsables de l’implémentation

En cas de substitution dans une classe dérivée, cette méthode recherche un DefaultValueAttribute. S’il en trouve un, il définit la valeur de la propriété sur le DefaultValueAttribute qu’il a trouvé. Si cette méthode ne trouve pas de DefaultValueAttribute, elle recherche une méthode « ResetMyProperty » que vous devez implémenter. S’il est trouvé, la méthode l’appelle ResetValue(Object) . Si ResetValue(Object) vous ne trouvez pas une DefaultValueAttribute méthode ou une méthode « ResetMyProperty » que vous avez implémentée, elle n’effectue pas d’opération.

S’applique à

Voir aussi