SetCharValue method

Builder Syntax	int __fastcall SetCharValue(Cardinal uCount);
Delphi Syntax	function SetCharValue(uCount: Cardinal): Integer;
Overview	Refer to Working with Data Sets.

Remarks

Sets the specified number of character values from the CharValues property into the item specified by the CurrentElement property.

Before calling this method, set the CharValueCount property to the number of values you wish to set, and then fill the CharValues property with the desired value(s).

If more than one value is stored in the Value Field of the Data Element, you must set all values at the same time.

A character has a standard size of one byte. When multiple characters are in the CharValues property, the first byte of data is the first character, the second byte of data is the second character, etc. Therefore no delimiters are needed.

If uCount is greater than the CharValueCount property, an error is returned.

This method overwrites the values associated with the item specified by the CurrentElement property.

This function can be called only if the Value Representation of the Data Element is VR_OB, VR_SQ, or VR_UN. For more information about Value Representations, refer to Default Value Representation Table.