SetCharValue method (ILEADDicomDS)

VB.NET example	C# example
Visual Basic example	Visual C++ 6.0 example

Syntax	short SetCharValue ( long lCount );
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 lCount is less than 0 or 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.

Elements:	SetBinaryValue method, SetShortValue method, SetLongValue method, SetFloatValue method, SetDoubleValue method, SetStringValue method, SetAgeValue method, SetDateValue method, SetTimeValue method, SetDateTimeValue method
Topics:	Data Sets: Getting and Setting Data Element Values