#include "Ltdic.h"
L_LTDIC_API pDICOMELEMENT L_DicomGetParentElement(hDS, pElement)
Returns a pointer to the item in the Data Set that contains the parent of the specified item.
A DICOM handle.
Pointer to a DICOMELEMENT structure that contains an item in the Data Set.
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.) |
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.
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:
Required DLLs and Libraries
Win32, x64, Linux.
This example displays the parent’s name of an element
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;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document