LDicomDS::FindNextPrivateCreatorDataElement

#include "Ltdic.h"

pDICOMELEMENT LDicomDS::FindNextPrivateCreatorDataElement(pElement, bTree, pszIdCode,uElementGroup)

pDICOMELEMENT pElement;

/* pointer to a DICOMELEMENT structure */

L_BOOL bTree;

/* flag that indicates how to evaluate the Data Set */

L_TCHAR * pszIdCode;

/* string used to uniquely identify the element */

L_UINT16 uElementGroup;

/* group to search within */

Returns the next Private Creator Data Element that matches the search constraints. This feature is available in version 16 or higher.

Parameter

Description

pElement

Pointer to a DICOMELEMENT structure within the Data Set. The search for Private Creator Data Elements will be at the same level as pElement.

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.

pszIdCode

Pointer to a string that uniquely identifies the Private Creator Data Element.

 

Value

Meaning

 

NULL

Search includes Private Creator Data Elements with any string value.

 

!NULL

Search includes only those Private Creator Data Elements that have a string value that is the same as pszIdCode.

uElementGroup

Group to search within.

 

Value

Meaning

 

0

Search includes Private Creator Data Elements with any group.

 

0x0010 to 0x00FF

Search includes only those Private Creator Data Elements in uElementGroup.

Returns

!NULL

A pointer to a DICOMELEMENT structure that contains the next Private Creator Data Element that matches the search constraints.

NULL

An item with the specified search constraints does not exist.

Comments

Use this method after calling LDicomDS::FindFirstPrivateCreatorDataElement to find any or all the Private Creator Data Elements in a DICOM data set.

The search for private creator data elements is on the same level as the element pointed to by argument pElement. For the argument pElement, pass the value returned by LDicomDS::FindFirstPrivateCreatorDataElement or the value returned by LDicomDS::FindNextPrivateCreatorDataElement.

If bTree is TRUE, the data set is searched as a tree. If bTree is FALSE, the data set is searched as a list. For more information on the use of this parameter, see LDicomDS::FindFirstElement.

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::CreatePrivateCreatorDataElement, LDicomDS::GetNextUnusedPrivateTag, LDicomDS::FindFirstPrivateCreatorDataElement, LDicomDS::FindFirstPrivateElement, LDicomDS::FindNextPrivateElement, Class Members

Topics:

Working with Data Sets

 

Data Sets: Searching a Data Set

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

For an example, refer to LDicomDS::FindFirstPrivateCreatorDataElement