System.TypInfo.GetPropValue

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetPropValue(Instance: TObject; const PropName: string;
PreferStrings: Boolean): Variant;
function GetPropValue(Instance: TObject; PropInfo: PPropInfo;
PreferStrings: Boolean): Variant;

C++

extern DELPHI_PACKAGE System::Variant __fastcall GetPropValue(System::TObject* Instance, const System::UnicodeString PropName, bool PreferStrings = true)/* overload */;

Eigenschaften

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


Beschreibung

Ruft den Wert einer Komponenteneigenschaft als Variante ab.

GetPropValue verwendet die RTTI (Laufzeittypinformationen) von Delphi, um eine Komponenteneigenschaft als Variante abzurufen.

Normalerweise kann der Typ Variant die Typen TObject, Menge, Methodenzeiger und Klasse nicht speichern. GetPropValue und SetPropValue können diese Typen aber behandeln. In diesen Fällen wird der Variant-Rückgabewert von SetPropValue nur mit demselben Eigenschaftstyp verwendet. Verwenden Sie diesen Variant-Rückgabewert nicht für andere Zwecke.

Wenn Sie den Eigenschaftstzp Variant abrufen möchten, müssen Sie GetVariantProp anstatt GetPropValue verwenden.

In einer Form dieser Funktion wird die Eigenschaft des Instance-Objekts durch einen PropInfo-Record definiert. GetPropInfo und GetPropList können zur Ermittlung eines solchen Records verwendet werden.

In der anderen Form dieser Funktion wird der Name der Eigenschaft, PropName, explizit angegeben.

In beiden Formen der Funktion wird der Wert der angegebenen Eigenschaft als Variante zurückgegeben.

Der Parameter PreferStrings gibt an, ob die String-Darstellung beim Ermitteln der Werte von Eigenschaften mit dem Typ Aufzählung oder Menge verwendet werden soll.

Hinweis: Wenn die angegebene Eigenschaft nicht vorhanden oder keine published-Eigenschaft ist, wird eine EPropertyError-Exception ausgelöst.

Siehe auch