Sdílet prostřednictvím


PropertyDescriptor.ResetValue(Object) Metoda

Definice

Při přepsání v odvozené třídě obnoví hodnotu této vlastnosti komponenty na výchozí hodnotu.

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)

Parametry

component
Object

Komponenta s hodnotou vlastnosti, která se má obnovit na výchozí hodnotu.

Poznámky

Tato metoda se obvykle implementuje prostřednictvím reflexe.

Tato metoda určuje hodnotu, na kterou se má vlastnost resetovat, v následujícím pořadí podle priority:

  1. Tato vlastnost má stínovou vlastnost.

  2. Pro tuto vlastnost je DefaultValueAttribute k dispozici.

  3. Existuje metoda ResetMyProperty, kterou jste implementovali, kde "MyProperty" je název vlastnosti, kterou do ní předáte.

Tato metoda vytvoří DesignerTransaction automaticky v následujícím pořadí:

  1. Metoda volá metodu IDesignerHost.CreateTransaction k vytvoření nového DesignerTransaction , který bude představovat změny.

  2. Metoda volá metodu IComponentChangeService.OnComponentChanging označující, že transakce byla zahájena a změny se chystanou.

  3. Metoda resetuje vlastnost na hodnotu určenou pořadím kontroly této metody.

  4. Metoda volá metodu IComponentChangeService.OnComponentChanged označující, že došlo ke změnám.

  5. Volání metody DesignerTransaction.Commit indikuje, že transakce je dokončena.

Účelem transakce je podpora Undo a Redo funkčnost.

Poznámky pro implementátory

Při přepsání v odvozené třídě tato metoda hledá DefaultValueAttribute. Pokud ji najde, nastaví hodnotu vlastnosti na nalezenou DefaultValueAttribute . Pokud tato metoda nemůže najít metodu DefaultValueAttribute, vyhledá metodu ResetMyProperty, kterou potřebujete implementovat. Pokud je nalezena, ResetValue(Object) metoda ji vyvolá. Pokud ResetValue(Object) nelze najít DefaultValueAttribute nebo "ResetMyProperty" metodu, kterou jste implementovali, neprovede operaci.

Platí pro

Viz také