GetNextUnusedPrivateTag Method

public int GetNextUnusedPrivateTag( 
   DicomElement privateCreatorDataElement
)

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

'Usage
 
Dim instance As DicomDataSet
Dim privateCreatorDataElement As DicomElement
Dim value As Integer
 
value = instance.GetNextUnusedPrivateTag(privateCreatorDataElement)

public int GetNextUnusedPrivateTag( 
   DicomElement privateCreatorDataElement
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomDataSet.GetNextUnusedPrivateTag( 
   privateCreatorDataElement 
)

public:
int GetNextUnusedPrivateTag( 
   DicomElement^ privateCreatorDataElement
) 

Parameters

privateCreatorDataElement

Private Creator Data Element

Return Value

This feature is available in version 16 or higher.

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

• CreatePrivateCreatorDataElement
• FindFirstPrivateCreatorDataElement
• FindNextPrivateCreatorDataElement

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

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DicomDataSet Class
DicomDataSet Members
Private Data Element Tags
CreatePrivateCreatorDataElement Method
GetNextUnusedPrivateTag Method
FindFirstPrivateCreatorDataElement Method
FindNextPrivateCreatorDataElement Method
FindFirstPrivateElement Method
FindNextPrivateElement Method