GetNextUnusedPrivateTag Method

Summary

Returns the next available unused tag reserved by the Private Creator Data Element.

Syntax

C++

Java

public int GetNextUnusedPrivateTag( 
   DicomElement privateCreatorDataElement 
)

Public Function GetNextUnusedPrivateTag( _ 
   ByVal privateCreatorDataElement As DicomElement _ 
) As Integer

public int getNextUnusedPrivateTag(DicomElement privateCreatorDataElement)

public: 
int GetNextUnusedPrivateTag(  
   DicomElement^ privateCreatorDataElement 
)

Parameters

privateCreatorDataElement
Private Creator Data Element

Return Value

The next unused private tag.

Remarks

This feature is available in version 16 or higher.

This method is used together with any of the following functions:

to create private elements in a DICOM data set. For more information on private elements, see CreatePrivateCreatorDataElement.

Use this method with an existing private creator data element to create private elements. If successful, the return value will be the next available unused tag that has been reserved by the Private Creator Data Element

For example, suppose the following tags exist in a DICOM data set:

(0017, 0012) private creator data element
(0017, 1200) private element
(0017, 1201) private element
(0017, 1205) private element

After a successful call to GetNextUnusedPrivateTag, the return value is 0x00171202, which can be used with InsertElement to add a new private element

Example

For an example, refer to CreatePrivateCreatorDataElement.

Requirements

Target Platforms