L_DicomGetParentElement

#include "Ltdic.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetParentElement(hDS, pElement)

HDICOMDS hDS;

a DICOM handle

pDICOMELEMENT pElement;

pointer to a DICOMELEMENT structure

Returns a pointer to the item in the Data Set that contains the parent of the specified item.

Parameter

Description

hDS

A DICOM handle.

pElement

Pointer to a DICOMELEMENT structure that contains an item in the Data Set.

Returns

!NULL

A pointer to a DICOMELEMENT structure that contains the item in the Data Set that is the parent of the item specified in pElement.

NULL

pElement has no parent. (pElement is a Level 0 item.)

Comments

The parent is the ancestor one level higher than the specified item. If the specified item is a Level 0 item, this function will return NULL. Please note that the numbering of the items in this illustration is arbitrary and does not imply order.

image\GetPrnt.gif

If the passed pointer points to :

The function returns a pointer to :

Item 1

NULL

Item 2

Item 3

Item 4

Item3

Item 5

Item 6

The following functions will also help you navigate the Data Set:

L_DicomGetFirstElement

L_DicomGetLastElement

L_DicomGetNextElement

L_DicomGetRootElement

L_DicomGetChildElement

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_DicomGetFirstElement, L_DicomGetLastElement, L_DicomGetNextElement, L_DicomGetPrevElement, L_DicomGetCountModule, L_DicomGetRootElement, L_DicomGetChildElement

Topics:

Working with Data Sets

Example

This example displays the parent’s name of an element

L_LTDICTEX_API L_INT DicomGetParentElementExample(L_VOID) 
{ 
   HDICOMDS       hDS; 
   pDICOMELEMENT  pParent; 
   pDICOMELEMENT  pElement; 
   pDICOMTAG      pTag; 
   L_TCHAR        szUnknown[]=TEXT("Unknown"); 
   L_TCHAR        *p; 
   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) 
   { 
      pParent = L_DicomGetParentElement(hDS, pElement); 
      if (pParent != NULL) 
      { 
         pTag = L_DicomFindTag(pParent->nTag); 
         if (pTag != NULL) 
         { 
            p = pTag->pszName; 
         } 
         else 
         { 
            p = szUnknown; 
         } 
         MessageBox(NULL, p, TEXT("Notice"), MB_OK); 
      } 
   } 
   L_DicomFreeDS(hDS); 
   return DICOM_SUCCESS; 
} 

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help
Click or drag to resize