LDicomDS::GetParentElement

Summary

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

Syntax

#include "Ltdic.h"

pDICOMELEMENT LDicomDS::GetParentElement(pElement)

Parameters

pDICOMELEMENT pElement

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

Returns

Value Meaning
!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.

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 Data Set:

LDicomDS::GetFirstElement

LDicomDS::GetLastElement

LDicomDS::GetNextElement

LDicomDS::GetRootElement

LDicomDS::GetChildElement

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Functions

Topics

Example

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

L_INT LDicomDS_GetParentElementExample() 
{ 
   LDicomDS*      pDS; 
   pDICOMELEMENT  pParent; 
   pDICOMELEMENT  pElement; 
   pDICOMTAG      pTag; 
   L_TCHAR        szUnknown[]=TEXT("Unknown"); 
   L_TCHAR*       p; 
 
   pDS = new LDicomDS(NULL); 
 
   pDS->InitDS( CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, 0);  
 
   pElement = pDS->FindFirstElement(NULL, TAG_RADIATION_SETTING, FALSE); 
   if (pElement != NULL) 
   { 
      pParent = pDS->GetParentElement(pElement); 
      if (pParent != NULL) 
      { 
         pTag = LDicomTag::Find(pParent->nTag); 
         if (pTag != NULL) 
         { 
            p = pTag->pszName; 
         } 
         else 
         { 
            p = szUnknown; 
         } 
 
         MessageBox(NULL, p, TEXT("Notice"), MB_OK); 
      } 
   } 
 
   delete pDS; 
 
   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++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.