System.TypInfo.GetStrProp

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetStrProp(Instance: TObject; const PropName: string): string;
function GetStrProp(Instance: TObject; PropInfo: PPropInfo): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall GetStrProp(System::TObject* Instance, const System::UnicodeString PropName)/* overload */;

Eigenschaften

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

Beschreibung

Gibt den Wert einer Komponenteneigenschaft zurück, die ein String-Typ ist.

GetStrProp verwendet die RTTI (Run Time Type Information) von Delphi, um den aktuellen Wert einer Komponenteneigenschaft zurückzugeben, die ein String-, LongString- oder WideString-Typ ist. Wenn die Eigenschaft nicht diesen Typ hat, wird ein leerer String zurückgegeben.

In der einen Form dieser Funktion wird die Eigenschaft Instance des Objekts durch einen PropInfo-Record definiert. Mit GetPropInfo und GetPropList kann dieser Record abgerufen werden.

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

In beiden Formen der Funktion wird der aktuelle Wert der Eigenschaft als String zurückgegeben.

Der intrinsische Wert dieser Funktion ermöglicht das Abrufen der Komponenteneigenschaften, ohne dass der Eigenschaftsname hart-codiert sein muss. Eine Massenverarbeitung visueller Komponenten zur Laufzeit ist somit möglich.

Mit GetPropValue können Sie einen Eigenschaftswert abrufen, wenn dessen Typ unbekannt ist - er wird als Variant-Typ zurückgegeben.

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

Siehe auch