L_DicomGetConvertValue

Summary

Converts the value of an element to a string and returns the number of characters in that string. Items in the string are separated by a '\'.

Syntax

#include "Ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetConvertValue(hDS, pElement, Destination, DestSizeInWords)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set.

L_TCHAR *Destination

Character string to be updated with the string version of the value.

L_UINT32 DestSizeInWords

Size of the destination string buffer.

Returns

Number of characters in the "Destination" parameter.

Comments

Call this function twice. The first should have "Destination" set to NULL. This will provide you with the size of the string that will be stored in "Destination". Next, allocate the memory required for "Destination" and call this function again to update "Destination" with the string.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

This example converts the value to a string and display it in a list-box control

L_INT DicomGetConvertValueExample(HDICOMDS hDS, pDICOMELEMENT pElement) 
{ 
   L_TCHAR *pszText;  
   L_TCHAR *p;  
   L_TCHAR *q;  
   L_UINT32 nLength;  
   L_UINT32 nCount;  
   L_UINT32 i;  
 
   nCount = L_DicomGetCountValue(hDS, pElement); 
   nLength = L_DicomGetConvertValue(hDS, pElement, NULL, 0); 
   pszText = (L_TCHAR *)malloc(nLength * sizeof(L_TCHAR)); 
   L_DicomGetConvertValue(hDS, pElement, pszText, nLength); 
 
   for (i = 0, p = pszText; i < nCount; i++) 
   { 
       q = _tcschr(p, '\\'); 
       if (q != NULL) 
       { 
          *q++ = 0; 
       } 
       MessageBox(NULL, p, TEXT("Value"), MB_OK); 
       p = q; 
   } 
 
   free(pszText); 
   L_DicomFreeValue(hDS, pElement); 
 
   return DICOM_SUCCESS; 
} 

Help Version 23.0.2024.7.1
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.