PropertyDescriptor.ResetValue(Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 :
Il existe une propriété ombrée pour cette propriété.
Il existe un DefaultValueAttribute pour cette propriété.
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 :
La méthode appelle la IDesignerHost.CreateTransaction méthode pour créer un nouveau DesignerTransaction afin de représenter les modifications.
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.
La méthode réinitialise la propriété à la valeur déterminée par l’ordre de vérification de cette méthode.
La méthode appelle la IComponentChangeService.OnComponentChanged méthode pour indiquer que les modifications ont eu lieu.
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.