L_DicomSetConvertValue

Show in webframe

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomSetConvertValue(hDS, pElement, strText, nCount)

HDICOMDS hDS;	/* a DICOM */
pDICOMELEMENT pElement;	/* pointer to a DICOMELEMENT structure */
L_TCHAR *strText;	/* character string */
L_UINT32 nCount;	/* number of values in pszText */

Converts a string and sets the value of an element. Items in the string are separated by a '\'.

Parameter	Description
hDS	A DICOM handle.
pElement	Pointer to a DICOMELEMENT structure within the Data Set.
strText	Character string that contains the string to be converted to 1 or more values.
nCount	Number of values in strText.

Returns

TRUE	The function completed successfully.
FALSE	The function did not complete successfully.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64, Linux.

See Also

Functions:	L_DicomGetConvertValue
Topics:	Working with Data Sets

Example

This example sets the value of an element

L_INT DicomSetConvertValueExample(L_VOID)
{
   HDICOMDS       hDS;
   pDICOMELEMENT  pElement;

   hDS = L_DicomCreateDS(NULL);

   L_DicomInitDS(hDS, CLASS_NM_IMAGE_STORAGE, 0); 

   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_STUDY_DATE, FALSE);
   if (!L_DicomSetConvertValue(hDS, pElement, TEXT("01/02/1999"), 1))
   {
      L_DicomFreeDS(hDS);
      return FAILURE - 1;
   }

   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_IMAGE_TYPE, FALSE);
   if (!L_DicomSetConvertValue(hDS, pElement, TEXT("DERIVED\\PRIMARY"), 2))
   {
      L_DicomFreeDS(hDS);
      return FAILURE - 1;
   }

   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_IMAGE_POSITION_PATIENT, FALSE);
   if (!L_DicomSetConvertValue(hDS, pElement, TEXT("0.123\\0.456\\1.789"), 3))
   {
      L_DicomFreeDS(hDS);
      return FAILURE - 1;
   }

   L_DicomFreeDS(hDS);
   return DICOM_SUCCESS;
}