#include "Ltdic.h"
pDICOMELEMENT LDicomDS::FindNextDescendant(pParent, pElement, bNextLevelOnly)
Returns a pointer to the next descendant of pParent having the specified tag.
Pointer to a parent DICOMELEMENT structure within the Data Set.
Pointer to a child DICOMELEMENT structure of pParent.
Flag that indicates how the Data Set will be evaluated. Possible values are:
Value | Meaning |
---|---|
TRUE | Search for items in the next level only. |
FALSE | Search for items recursively in all the next levels. |
Value | Meaning |
---|---|
!NULL | A pointer to a DICOMELEMENT structure that contains the first item in the Data Set with the specified tag. |
NULL | An item with the specified tag was not found. |
NOTE: This function does not specify a tag to use when searching. However the tag that was used in the last call to LDicomDS::FindFirstDescendant is used by default when searching.
This function finds the next descendant of the pElement that has a DICOM tag equivalent to the nTag argument (LDicomDS::FindFirstDescendant), where the entire search is rooted at the Parent element (i.e. pParent).
The diagram below represents DICOM elements stored in a DICOM dataset.
Behavior when bNextLevelOnly is TRUE:
Returns the next element on the next level of pParent that has tag equivalent to the nTag argument used in the previous call to LDicomDS::FindFirstDescendant. Elements included in the search include child elements in the next level only, starting with the element pointed to by pElement.
Example 1
bNextLevelOnly TRUE
pParent points to element 1
pElement points to element 8
Searches elements 11, 12 and returns the first element that matches the nTag argument used in the previous call to LDicomDS::FindFirstDescendant.
Example 2
bNextLevelOnly TRUE
pParent points to element 2
pElement points to element 3
Searches elements 4, 7 and returns the first element that matches the nTag argument used in the previous call to LDicomDS::FindFirstDescendant.
Example 3
bNextLevelOnly TRUE
pParent pointing to element 4
pElement points to element 5
Searches element 6 only, and returns element 6 if it has a tag equivalent to the nTag argument used in the previous call to LDicomDS::FindFirstDescendant.
Example 4
bNextLevelOnly TRUE
pParent pointing to element 1
pElement points to element 12
Returns NULL.
Behavior when bNextLevelOnly is FALSE:
Returns the next item that has tag equivalent to the nTag argument used in the previous call to LDicomDS::FindFirstDescendant, using a pre-order search algorithm rooted at pParent.
Example 5
bNextLevelOnly FALSE
pParent pointing to element 1
pElement points to element 4
Searches elements 5, 6, 7, 8, 9, 10, 11, 12 and returns the first element that matches the nTag argument used in the previous call to LDicomDS::FindFirstDescendant.
Example 6
bNextLevelOnly FALSE
pParent pointing to element 2
pElement points to element 4
Searches elements 5, 6, 7 and returns the first element that matches the nTag argument used in the previous call to LDicomDS::FindFirstDescendant.
Example 7
bNextLevelOnly FALSE
pParent pointing to element 4
pElement points to element 5
Searches element 6 only, and returns element 6 if it has a tag equivalent to the nTag argument used in the previous call to LDicomDS::FindFirstDescendant.
The following functions can also help you find elements in the Data Set with a specific tag:
The following functions will help you find specific modules in the Data Set:
LDicomDS::FindIndexModule
Required DLLs and Libraries
Win32, x64
For an example, refer to LDicomDS::FindFirstDescendant.
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
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.