System.TypInfo.TPublishableVariantType.SetProperty

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function SetProperty(const V: TVarData; const Name: string;  const Value: TVarData): Boolean; override;

C++

virtual bool __fastcall SetProperty(const TVarData &V, const System::UnicodeString Name, const TVarData &Value);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.TypInfo.pas
System.TypInfo.hpp
System.TypInfo TPublishableVariantType

Beschreibung

Setzt den Wert einer als published deklarierten Eigenschaft des von GetInstance zurückgegebenen Objekts und macht ihn für die benutzerdefinierte Variante verfügbar.

SetProperty ermöglicht der Anwendung, den Eigenschaften der Instanzen des Variantentyps Werte zuzuweisen. Die Methode implementiert alle setzbaren Eigenschaften, die in dem von GetInstance zurückgegebenen Objekt als published deklariert sind.

Enthält eine Anwendung eine Zeile wie

MyVariant.SpecialProperty := NewValue;

(Delphi) oder ruft die Methode Exec der Variante (C++) auf, wird automatisch ein Aufruf von SetProperty generiert. Wenn SpecialProperty in dem Objekt, das die Daten der Variante implementiert, als published deklariert und nicht schreibgeschützt ist, weist SetProperty der entsprechenden Eigenschaft des Objekts V den Wert dieser Eigenschaft zu.

V ist der TVarData-Record (Delphi) bzw. die Struktur (C++) der Varianteninstanz, deren Eigenschaft gelesen wird. Der Parameter enthält das von GetInstance zurückgegebene Objekt.

Name ist der Name der Eigenschaft.

Value ist der Record (TVarData) bzw. die Struktur mit dem neuen Wert der Eigenschaft.

Wenn bei der Operation ein Eigenschaftswert zugewiesen wird, gibt SetProperty true zurück. Andernfalls wird eine Exception ausgelöst.

Siehe auch