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

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

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

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

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

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

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

関連項目