LDicomDS::FindFirstPrivateCreatorDataElement

Functions

• LDicomDS::CreatePrivateCreatorDataElement
• LDicomDS::GetNextUnusedPrivateTag
• LDicomDS::FindNextPrivateCreatorDataElement
• LDicomDS::FindFirstPrivateElement
• LDicomDS::FindNextPrivateElement
• Class Members

Topics

• Working with Data Sets
• Data Sets: Searching a Data Set
• How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example shows the steps to properly reserve and insert some private tags:

1. Reserve elements by first creating a 'Private Creator Data Element'-- create in group 'uGroup', and take first available element

2. Now insert five private elements that have been reserved by the 'Private Creator Data Element'

   L_INT LDicomDS_CreatePrivateCreatorDataElementExample(LDicomDS &ds, pDICOMELEMENT pRoot, L_UINT16 uElementGroup) 
   { 
      L_INT nRet = DICOM_SUCCESS; 
      L_UINT32 uTag = 0; 
      TCHAR *pszUniqueID = L"MyPrivateCreatorDataElement"; 
    
      // We will add some private tags 
      // First see if the Private Creator Data Element already exists -- search by unique ID, ANY group 
      pDICOMELEMENT pPrivateCreatorElement = ds.FindFirstPrivateCreatorDataElement(pRoot, TRUE, pszUniqueID, 0); 
    
      // If the Private Creator Data Element does not exist, try to create it 
      if (pPrivateCreatorElement == NULL) 
      { 
         nRet = ds.CreatePrivateCreatorDataElement(pRoot, uElementGroup, 0xFF, pszUniqueID, &pPrivateCreatorElement); 
         if (nRet != DICOM_SUCCESS) 
            return nRet; 
    
         // Private Creator Data Element tag was created successfully 
         // Add it to the DICOM Tag table  
         LDicomTag::Insert( 
            pPrivateCreatorElement->nTag,  
            0xFFFFFFFF,  
            pszUniqueID,  
            pPrivateCreatorElement->nVR, 
            1,1,1 
            ); 
      } 
    
      // Insert some private elements 
      for (int i = 0; i<5; i++) 
      { 
         nRet = ds.GetNextUnusedPrivateTag(pPrivateCreatorElement, &uTag); 
         if (nRet == DICOM_SUCCESS) 
         { 
            pDICOMELEMENT p = ds.InsertElement(pRoot, FALSE, uTag, VR_IS, FALSE, 0); 
            if (p) 
            { 
               ds.SetLongValue(p, &i, 1); 
            } 
         } 
      } 
      return nRet; 
   }