SetName Method

Summary

Sets the name of the specified item in the Value Representation Table.

Syntax

Objective-C

C++/CLI

Java

public bool SetName( 
   DicomVR vr, 
   string name 
)

- (BOOL)setName:(NSString *)name forVR:(LTDicomVR *)vr;

public boolean setName(DicomVr vr, String name)

public: 
bool SetName(  
   DicomVR^ vr, 
   String^ name 
)

Parameters

vr
An item in the Value Representation Table. The name of this item will be set using name.

name
the name to be set

Return Value

true if the name was successfully set, false if there is no enough memory

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(); 
}