SetName Method

Summary

Sets the name of the specified item in the UID Table.

Syntax

Objective-C

C++/CLI

Java

public bool SetName( 
   DicomUid uid, 
   string name 
)

- (BOOL)setName:(NSString *)name forUid:(LTDicomUid *)uid;

public boolean setName(DicomUid uid, String name)

public: 
bool SetName(  
   DicomUid^ uid, 
   String^ name 
)

Parameters

uid
An item in the UID 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 TestUIDTable() 
{ 
 
   //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 
   DicomUidTable.Instance.Reset(); 
   DicomUidTable.Instance.Default(); 
 
   //We can also call FindByIndex if we know the index of this UID 
   DicomUid uid = DicomUidTable.Instance.Find(DicomUidType.SCImageStorage); 
   DicomUidTable.Instance.Delete(uid); 
 
   DicomUid uid1 = DicomUidTable.Instance.Insert(DicomUidType.SCImageStorage, "Secondary Capture Image Storage", DicomUIDCategory.Class); 
   Debug.Assert(DicomUidTable.Instance.Exists(uid1) == true); 
   DicomUidTable.Instance.SetName(uid1, "Secondary Capture Image Storage 1"); 
 
   int count = 0; 
   //If we want to loop through all the UIDs in the table we can do this: 
   uid = DicomUidTable.Instance.GetFirst(); 
   while (uid != null) 
   { 
      // We can also access the rest of the properties of DicomUid in here, 
      // such as DicomUid.Code, DicomUid.Name, DicomUid.Type 
 
      if (uid.Code == DicomUidType.SCImageStorage) 
      { 
         Console.WriteLine(uid.Name); 
      } 
      count++; 
      uid = DicomUidTable.Instance.GetNext(uid); 
   } 
   //We can use GetLast and GetPrevious to achieve the same thing 
 
   Debug.Assert(count == DicomUidTable.Instance.GetCount()); 
 
   DicomEngine.Shutdown(); 
}