System.TypInfo.GetPropValue

提供:RAD Studio API Documentation

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 */;

プロパティ

種類 可視性 ソース ユニット 親
function public
System.TypInfo.pas
System.TypInfo.hpp
System.TypInfo System.TypInfo


説明

コンポーネントのプロパティ値をバリアントとして取得します。

GetPropValue は、Delphi の RTTI(実行時型情報)を利用し、コンポーネントのプロパティをバリアントとして取得します。

通常、Variant 型は、型 TObject、セット、メソッド ポインタ、クラスを保持できません。 ただし、GetPropValue と SetPropValue は、これらの型を処理することができます。 これらの場合、戻り値 Variant は、同じプロパティ型を持つ SetPropValue によってのみ使用されます。この戻り値 Variant を他の目的に使用してはいけません。

Variant 型のプロパティを取得したい場合には、GetPropValue の代わりに GetVariantProp を使用しなければなりません。

この関数のある形式では、オブジェクト Instance のプロパティは、PropInfo レコードで定義されます。GetPropInfo および GetPropList は、そのようなレコードを取得するために使用されます。

この関数の他の形式では、プロパティ名 PropName が明示的に与えられます。

どちらの形式の関数でも、指定されたプロパティの値は、バリアントとして返されます。

PreferStrings パラメータは、型列挙値またはセットのプロパティ値を取得する際、文字列表現が使用されるべきかどうかを示します。

メモ: 指定されたプロパティがなかった場合、または、公開プロパティでなかった場合、EPropertyError 例外が投げられます。

関連項目