LDicomIOD::GetParent

#include "Ltdic.h"

static pDICOMIOD LDicomIOD::GetParent(pIOD)

Returns a pointer to the item in the IOD Structure that contains the parent of the specified item.

Parameters

pDICOMIOD pIOD

Pointer to a DICOMIODstructure that contains an item in the IOD Structure.

Returns

Value Meaning
!NULL A pointer to a DICOMIODstructure that contains the item in the IOD Structure that is the parent of the item specified in pIOD.
NULL pIOD has no parent. (pIOD is a Level 0 item.)

Comments

This function requires that the IOD Structure is evaluated as a tree structure.

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.

NOTE: 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 Item 3
Item 5 Item 6

The following functions will also help you navigate the IOD Structure:

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Functions

Topics

Example

This example displays the parent’s name of an item.

L_INT LDicomIOD_GetParentExample() 
{ 
   pDICOMIOD   pParent; 
   pDICOMIOD   pElement; 
 
   pElement = LDicomIOD::Find(NULL, TAG_PATIENT_NAME, IOD_TYPE_ELEMENT, FALSE); 
   if (pElement != NULL) 
   { 
      pParent = LDicomIOD::GetParent(pElement); 
      ::MessageBox(NULL, pParent->pszName, TEXT("Notice"), MB_OK); 
   } 
 
   return DICOM_SUCCESS; 
} 

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

LEADTOOLS DICOM C++ Class Library Help