In This Topic ▼
LDicomDS::GetRootKey
Summary
Returns a pointer to the root of the specified item.
Syntax
#include "ltdic.h"
pDICOMELEMENT LDicomDS::GetRootKey(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 root of the item specified in pElement. |
| NULL | The Data Set is empty or pElement is NULL. |
Comments
The root is the Level 0 ancestor of pElement. If pElement points to an item on Level 0, a pointer to that same item will be returned.
NOTE: 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 | Item 2 |
| Item 3 | Item 2 |
| Item 4 | Item 4 |
| Item 5 | Item 6 |
The following functions will also help you navigate the Data Set:
- LDicomDS::GetFirstKey
- LDicomDS::GetLastKey
- LDicomDS::GetNextKey
- LDicomDS::GetParentKey
- LDicomDS::GetChildKey
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::GetFirstKey
- LDicomDS::GetLastKey
- LDicomDS::GetNextKey
- LDicomDS::GetPrevKey
- LDicomDS::GetParentKey
- LDicomDS::GetChildKey
Topics
- Working with Basic Directory Key Elements
- How to Disable the Automatic Loading of the default DICOM IOD Table
Example
For an example, refer to LDicomDS::InsertKey.
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
