SetName Method

Summary

Sets the name of the specified item in the Data Element Tag Table.

Syntax

Objective-C

C++/CLI

Java

public bool SetName( 
   DicomTag tag, 
   string name 
)

- (BOOL)setName:(NSString *)name forTag:(LTDicomTag *)tag;

public boolean setName(DicomTag tag, String name)

public: 
bool SetName(  
   DicomTag^ tag, 
   String^ name 
)

Parameters

tag
An item in the Data Element Tag 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 TestTagTable() 
{ 
 
   //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 
   DicomTagTable.Instance.Reset(); 
   DicomTagTable.Instance.Default(); 
 
   //We can also call FindByIndex if we know the index of this Tag 
   DicomTag tag = DicomTagTable.Instance.Find(DicomTag.PatientName); 
   DicomTagTable.Instance.Delete(tag); 
 
   DicomTag tag1 = DicomTagTable.Instance.Insert(DicomTag.PatientName, 0xFFFFFFFF, "Patient's Name", DicomVRType.PN, 1, 1, 1); 
 
   Console.WriteLine("Tag Information:"); 
   Console.WriteLine("code is:         {0}", tag1.ToHexString()); 
   Console.WriteLine("VR is :          {0}", tag1.VR); 
   Console.WriteLine("MinVM is :       {0}", tag1.MinVM); 
   Console.WriteLine("MaxVM is :       {0}", tag1.MaxVM); 
   Console.WriteLine("VMDivider is :   {0}", tag1.VMDivider); 
 
   Debug.Assert(DicomTagTable.Instance.Exists(tag1) == true); 
   DicomTagTable.Instance.SetName(tag1, "Patient's Name 1"); 
 
   int count = 0; 
   //If we want to loop through all the Tags in the table we can do this: 
   tag = DicomTagTable.Instance.GetFirst(); 
   while (tag != null) 
   { 
      // We can also access the rest of the properties of DicomTag in here, 
      // such as DicomTagType.Code, DicomTagType.Name, DicomTagType.Mask 
 
      if (tag.Code == DicomTag.PatientName) 
      { 
         Console.WriteLine(tag.Name); 
      } 
      count++; 
      tag = DicomTagTable.Instance.GetNext(tag); 
   } 
   //We can use GetLast and GetPrevious to achieve the same thing 
 
   Debug.Assert(count == DicomTagTable.Instance.GetCount()); 
 
   DicomEngine.Shutdown(); 
}