LDicomDS::GetNextKey

Summary

Returns a pointer to the item in the Dicom Dir Data Set that immediately follows the specified item.

Syntax

pDICOMELEMENT LDicomDS::GetNextKey(pElement, bTree)

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 follows this item will be returned.

L_BOOL bTree

Flag that indicates how the Data Set will be evaluated. Possible values are:

Returns

Comments

If the Data Set is evaluated as a tree structure, this function returns the next 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 Data Set is evaluated as a list, the next 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.

The following functions will also help you navigate the Data Set as either a tree or a list:

LDicomDS::GetFirstKey

LDicomDS::GetPrevKey

LDicomDS::GetLastKey

If you evaluate the Data Set as a tree, you can also use the following functions to navigate the tree:

LDicomDS::GetRootKey

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::GetPrevKey
• LDicomDS::GetLastKey
• 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.