SetStringValue method

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

Remarks

Sets the specified number of string values from the StringValues property into the item specified by the CurrentElement property.

Before calling this method, set the StringValueCount property to the number of values you wish to set, and then fill the StringValues 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.

For more information on required delimiters between multiple values, refer to An Overview of the DICOM File Format and the DICOM Standard.

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_AE, VR_CS, VR_LO, VR_LT, VR_SH, VR_ST, VR_UI, VR_UT, or VR_PN. For more information about Value Representations, refer to Default Value Representation Table.