System.TypInfo.GetOrdProp

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

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

Properties

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

Description

Returns the value of a component property that is an ordinal type or a class type.

GetOrdProp utilizes Delphi's RTTI (Run Time Type Information) to return the current value of a component's property. The property should be of an ordinal type like Integer, Char, and WideChar, or a class type.

In one form of this function, the object Instance's property is defined by a PropInfo record. GetPropInfo and GetPropList can be used to obtain such a record.

In the other form of this function, the name of the property, PropName, is explicitly given.

In both forms of the function, the current value of the property is returned as a NativeInt integer value.

The intrinsic value of this function is to allow retrieval of component properties without the need to hard-code the property name. This allows mass visual component processing at run time.

Use GetPropValue to retrieve a property value where the type is unknown--it is returned in a Variant type.

Note: If the specified property does not exist, or is not a published property, an EPropertyError exception is thrown.

See Also