System.TypInfo.SetSetProp

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure SetSetProp(Instance: TObject; const PropName: string; const Value: string);
procedure SetSetProp(Instance: TObject; PropInfo: PPropInfo; const Value: string);

C++

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

Properties

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

Description

Sets the value of a component property that is a set type.

SetSetProp utilises Delphi's RTTI (Run Time Type Information) to set the value of a component's property where that property is a set 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 new property value is defined by Value. You specify the set of values as a comma separated string. You may optionally enclose these in square brackets. This allows the returned value from one GetSetProp call to be used as the assignment value in a SetSetProp call.

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

Use SetPropValue to set a property value where the type is unknown. This would normally be used when using GetPropValue from another property.

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

See Also