Insert Method (original) (raw)
Summary
Inserts a new item in the Value Representation Table.
Syntax
Parameters
code
Code that indicates the type of value to be stored in the data element.
length
The length of the value to be stored in the data element
restriction
Restrictions on the length.
unitSize
The size of the smallest item to be stored in the value field of the data element
Return Value
DicomVR class if the method was successful; otherwise, null.
Example
using Leadtools;
using Leadtools.Dicom;
public void TestVRTable()
{
//Make sure to initialize the DICOM engine, this needs to be done only once
//In the whole application
DicomEngine.Startup();
//We don't need to call this since the DicomEngine.Startup already does that for us
//These calls are for demonstration purposes only
DicomVRTable.Instance.Reset();
DicomVRTable.Instance.Default();
//We can also call FindByIndex if we know the index of this VR
DicomVR vr = DicomVRTable.Instance.Find(DicomVRType.AE);
DicomVRTable.Instance.Delete(vr);
DicomVR vr1 = DicomVRTable.Instance.Insert(DicomVRType.AE, "My AE VR", 16, DicomVRRestriction.StringFixed, 1);
Debug.Assert(DicomVRTable.Instance.Exists(vr1) == true);
DicomVRTable.Instance.SetName(vr1, "My New AE VR");
int count = 0;
//If we want to loop through all the VRs in the table we can do this:
vr = DicomVRTable.Instance.GetFirst();
while (vr != null)
{
// We can also access the rest of the properties of DicomVR in here,
// such as DicomVRType.Code, DicomVRType.Length, DicomVRType.Name,
// DicomVRType.Restriction and DicomVRType.UnitSize
if (vr.Code == DicomVRType.AE)
{
Console.WriteLine(vr.Name);
}
count++;
vr = DicomVRTable.Instance.GetNext(vr);
}
//We can use GetLast and GetPrevious to achieve the same thing
Debug.Assert(count == DicomVRTable.Instance.GetCount());
DicomEngine.Shutdown();
}