LDicomDS::GetPrevKey
#include "ltdic.h"
pDICOMELEMENT LDicomDS::GetPrevKey(pElement, bTree)
Returns a pointer to the item in the Dicom Dir Data Set that immediately precedes the specified item.
Parameters
pDICOMELEMENT pElement
Pointer to a DICOMELEMENT structure that contains an item in the Data Set. A pointer to the item in the Data Set that immediately precedes this item will be returned.
L_BOOL bTree
Flag that indicates how the Data Set will be evaluated. Possible values are:
| Value | Meaning |
|---|---|
| TRUE | Evaluate the Data Set as a tree. |
| FALSE | Evaluate the Data Set as a list. |
Returns
| Value | Meaning |
|---|---|
| !NULL | A pointer to a DICOMELEMENTstructure that contains the item in the Data Set that immediately precedes the item specified in pElement. |
| NULL | There is not an item preceding pElement. (pElement is the first item in the Data Set.) |
Comments
If the Data Set is evaluated as a tree structure, this function returns the previous item on the same level as pElement with the same parent as pElement.
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 4 |
| Item 5 | NULL |
| Item 6 | Item 7 |
If the Data Set is evaluated as a list, the previous item in the list is returned.
NOTE: The numbering of the items in this illustration does indicate the order of the items when the Data Set is evaluated as a list.
| If the passed pointer points to | The function returns a pointer to |
|---|---|
| Item 1 | NULL |
| Item 15 | Item 14 |
| Item 5 | Item 4 |
| Item 9 | Item 8 |
| Item 22 | Item 21 |
| Item 25 | Item 24 |
The following functions will also help you navigate the Data Set as either a tree or a list:
If you evaluate the Data Set as a tree, you can also use the following functions to navigate the tree:
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
Win32, x64
Functions
- LDicomDS::GetFirstKey
- [LDicomDS:GetPrevKey
- LDicomDS::GetNextKey
- LDicomDS::GetRootKey
- 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.
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.
