L_DicomSetConvertValue

#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

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;
}