System.TypInfo.GetPropInfo

From Appmethod Libraries
Jump to: navigation, search

Object Pascal

function GetPropInfo(TypeInfo: PTypeInfo; const PropName: string): PPropInfo;
function GetPropInfo(TypeInfo: PTypeInfo; const PropName: string; AKinds: TTypeKinds): PPropInfo;
function GetPropInfo(Instance: TObject; const PropName: string; AKinds: TTypeKinds): PPropInfo;
function GetPropInfo(AClass: TClass; const PropName: string; AKinds: TTypeKinds): PPropInfo;

C++

extern DELPHI_PACKAGE PPropInfo __fastcall GetPropInfo(PTypeInfo TypeInfo, const System::UnicodeString PropName)/* overload */;

Properties

Type Visibility Source Unit Parent
function public
System.TypInfo.pas
System.TypInfo.hpp
System.TypInfo System.TypInfo

Description

Retrieves information about a component's property.

GetPropInfo utilises Object Pascal's RTTI (Run Time Type Information) to retrieve a pointer to a property information record for a component.

In the first form of this function, TypeInfo specifies the component type whose property you want to retrieve. PropName specifies the property name as a string. You may optionally specify a AKinds set of TTypeKind property value types that the property must belong to.

The second form of the function is similar to the first, with AClass replacing TypeInfo as the means of specifying the component type. AKinds is now a required value.

The final form of the function is like the second form, with Instance specifying a component instance.

In all forms of the function, the returned value is a pointer to a TPropInfo value. This provides rich data about the property being investigated at run time. This enables more elegant component processing than can be achieved with hard coded component names/properties.

Note: If the specified property does not exist, a nil pointer is returned.

See Also