RAD Studio VCL Reference
TypInfo.SetUnicodeStrProp Function

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

procedure SetUnicodeStrProp(Instance: TObject; const PropName: string; const Value: UnicodeString); overload;
procedure SetUnicodeStrProp(Instance: TObject; PropInfo: PPropInfo; const Value: UnicodeString); overload;
SetUnicodeStrProp(TObject * Instance, const AnsiString PropName, const UnicodeString Value);
SetUnicodeStrProp(TObject * Instance, PPropInfo PropInfo, const UnicodeString Value);

SetUnicodeStrProp uses Delphi's RTTI (Run Time Type Information) to set the value of a component's property where that property is a UnicodeString.  

In one form of this function, the property is looked up by using the data in the PropInfo parameter. 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.  

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.


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!