LDicomDS::GetParentKey
#include "ltdic.h"
pDICOMELEMENT LDicomDS::GetParentKey(pElement)
pDICOMELEMENT pElement; |
/* pointer to a DICOMELEMENT structure */ |
Returns a pointer to the item in the Dicom Dir 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.
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
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 |
See Also
Functions: |
LDicomDS::GetFirstKey, LDicomDS::GetLastKey, LDicomDS::GetNextKey, LDicomDS::GetPrevKey, LDicomDS::GetRootKey, LDicomDS::GetChildKey |
Topics: |
Example
For an example, refer to LDicomDS::InsertKey.