L_DicomGetLevelElement

Summary

Returns a value that indicates the level at which the specified element is located within the Data Set.

Syntax

#include "Ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetLevelElement(hDS, pElement)

Parameters

HDICOMDS hDS

Pointer to a class.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set.

Returns

The level at which the specified element is located within the Data Set.

Comments

This function requires that the Data Set is evaluated as a tree.

The following illustration gives an example:

image\GetLevel.gif
If the passed pointer points to The function returns
Item 1 0
Item 2 1
Item 3 2

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Topics

Example

This example displays the level of an element 

L_INT DicomGetLevelElementExample(L_VOID) 
{ 
   HDICOMDS       hDS; 
   pDICOMELEMENT  pElement; 
   L_UINT32       nLevel; 
   L_TCHAR         szText[30]; 
 
   hDS = L_DicomCreateDS(NULL); 
 
   L_DicomInitDS(hDS, CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, 0);  
 
   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_RADIATION_SETTING, FALSE); 
   if (pElement != NULL) 
   { 
      nLevel = L_DicomGetLevelElement(hDS, pElement); 
      wsprintf(szText, TEXT("%ld"), nLevel); 
      MessageBox(NULL, szText, TEXT("Notice"), MB_OK); 
   } 
 
   L_DicomFreeDS(hDS); 
   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
Introduction
Version History
Getting Started
Features of LEADTOOLS DICOM
Redistributables/Files To Be Included With Your Application
Quick Reference
Function References
Appendix
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.