Insert Method (DicomTagTable)

public DicomTag Insert( 
   long code,
   long mask,
   string name,
   DicomVRType vr,
   long minVM,
   long maxVM,
   long vmDivider
)

'Declaration
 
Public Function Insert( _
   ByVal code As Long, _
   ByVal mask As Long, _
   ByVal name As String, _
   ByVal vr As DicomVRType, _
   ByVal minVM As Long, _
   ByVal maxVM As Long, _
   ByVal vmDivider As Long _
) As DicomTag

'Usage
 
Dim instance As DicomTagTable
Dim code As Long
Dim mask As Long
Dim name As String
Dim vr As DicomVRType
Dim minVM As Long
Dim maxVM As Long
Dim vmDivider As Long
Dim value As DicomTag
 
value = instance.Insert(code, mask, name, vr, minVM, maxVM, vmDivider)

public DicomTag Insert( 
   long code,
   long mask,
   string name,
   DicomVRType vr,
   long minVM,
   long maxVM,
   long vmDivider
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomTagTable.Insert( 
   code ,
   mask ,
   name ,
   vr ,
   minVM ,
   maxVM ,
   vmDivider 
)

public:
DicomTag^ Insert( 
   int64 code,
   int64 mask,
   String^ name,
   DicomVRType vr,
   int64 minVM,
   int64 maxVM,
   int64 vmDivider
) 

Parameters

code

Code that indicates the tag. For a list of default values, refer to Data Element Tag Values.

mask

Masking value. Masking allows you to insert multiple elements in the same entry in the table.

name

The name of the tag. For a list of default values, refer to the Data Element Tag Table.

vr

Value representation code that indicates the type of value stored in the data element.

minVM

The minimum number of values that may be stored in the Value Field of the Data Element.

maxVM

The maximum number of values that may be stored in the Value Field of the Data Element.

vmDivider

Value used to divide the value multiplicity. When multiple values are stored in the value field of a data element, the number of values present must be evenly divisible by vmDivider. For most items vmDivider will be 1. However, if the values stored in the value field are RGB triplets, for example, you would have to store three values for each triplet. You could store 12 values, since 12 values would be 4 triplets, however, you could not store 13 values. In this case vmDivider would be 3.

Return Value

• All items are inserted at the bottom of the table.
• To see the default values for the Data Element Tag Table, refer to the Data Element Tag Table.
• For more information on the DICOM file format, refer to An Overview of the DICOM File Format or the DICOM Standard.

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

DicomTagTable Class
DicomTagTable Members
Delete Method
Reset Method
Default Method