LDicomDS::GetConvertValue

#include "Ltdic.h"

L_UINT32 LDicomDS::GetConvertValue(pElement, Destination, DestSizeInWords)

pDICOMELEMENT pElement;	pointer to a DICOMELEMENT structure
L_TCHAR *Destination;	character string
L_UINT32 DestSizeInWords;	size of the destination string buffer

Converts the value of an element to a string, and returns the number of characters in that string.

Parameter	Description
pElement	Pointer to a DICOMELEMENT structure within the Data Set.
Destination	Character string to be updated with the string version of the value.
DestSizeInWords	Size of the Destination 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

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

Example

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

L_INT LDicomDS_GetConvertValueExample(LDicomDS *pDS, pDICOMELEMENT pElement) 
{ 
   L_TCHAR* pszText; 
   L_TCHAR* p; 
   L_TCHAR* q; 
   L_UINT32 nLength; 
   L_UINT32 nCount; 
   L_UINT32 i; 
   nCount  = pDS->GetCountValue(pElement); 
   nLength = pDS->GetConvertValue(pElement, NULL, 0); 
   pszText = (L_TCHAR *)malloc(nLength * sizeof(L_TCHAR)); 
   pDS->GetConvertValue(pElement, pszText, nLength); 
   for (i = 0, p = pszText; i < nCount; i++) 
   { 
      q = wcschr(p, '\\'); 
      if (q != NULL) 
      { 
         *q++ = 0; 
      } 
      ::MessageBox(NULL, p, TEXT("Value"), MB_OK); 
      p = q; 
   } 
   free(pszText); 
   pDS->FreeValue(pElement); 
   return DICOM_SUCCESS; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C++ Class Library Help

Introduction

Version History

Getting Started

LEADTOOLS DICOM Features

Redistributables/Files To Be Included With Your Application

Quick Reference

Classes and Member Functions

CallBack Functions

Appendix

Functions:	LDicomDS::SetConvertValue
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table