LDicomDS::GetParentElement

#include "Ltdic.h"

pDICOMELEMENT LDicomDS::GetParentElement(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
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:

LDicomDS::GetFirstElement

LDicomDS::GetLastElement

LDicomDS::GetNextElement

LDicomDS::GetRootElement

LDicomDS::GetChildElement

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

See Also

Functions:	LDicomDS::GetFirstElement, LDicomDS::GetLastElement, LDicomDS::GetNextElement, LDicomDS::GetPrevElement, LDicomDS::GetCountModule, LDicomDS::GetRootElement, LDicomDS::GetChildElement
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

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;
}