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

Visual Basic (Usage)	Copy Code
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
)

public:
DicomTag^ Insert( 
   long code,
   long mask,
   String^ name,
   DicomVRType vr,
   long minVM,
   long maxVM,
   long 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: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

Reference