AddDictionaryElement Method

In This Topic

Description

Add private or new attribute description to the internal list

Syntax

Visual Basic
Public Sub AddDictionaryElement( _ ByVal Group As Long, _ ByVal Element As Long, _ ByVal VR As String, _ ByVal VM As String, _ ByVal Description As String _ )

Visual Basic

Public Sub AddDictionaryElement( _
   ByVal Group As Long, _
   ByVal Element As Long, _
   ByVal VR As String, _
   ByVal VM As String, _
   ByVal Description As String _
)

Parameters

Group: Group tag for the new element
Element: Element tag for the new element
VR: A standard 2 character DICOM VR,
e.g. “PN” for personal
VM: Allowed multiplicity
e.g. “1”, “1-n”, “3” etc.
Description: Description of the element, as used in the DicomAttribute’s Description property

Remarks

This method is equally useful for adding new official attributes added after a release of DicomObjects, or for adding private attributes, to be handled as if they were “official”.
Although any value for VM is allowed, the only value with any special internal significance is “1”, as this causes DicomAttribute’s default Value property to return a single value. Any other value causes an array to be returned.
An alternative, if values only need to be created, is to use the AddExplicit method.