In This Topic ▼

L_DicomSetTextObjectInfo

Summary

Updates the attributes of a text annotation object.

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomSetTextObjectInfo(hDS, pGraphicAnnSQItem, uTextObjectIndex, pTextObject)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0008,1115) in the "Graphic Annotation Module".

L_UINT uTextObjectIndex

Index of the text annotation object to be updated

pDICOMTEXTOBJECT pTextObject

Structure containing the text annotation object attributes.

Returns

Value	Meaning
DICOM_SUCCESS	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

Before calling this function, initialize pTextObject->uStructSize to be sizeof(DICOMTEXTOBJECT) and initialize all the structure members.

Required DLLs and Libraries

LTDIC
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64, Linux.

Example

L_INT DicomSetTextObjectInfoExample(HDICOMDS hPresStateDS) 
{ 
   DICOMTEXTOBJECT   TextObject; 
   L_FLOAT           pAnchorPoint[2]; 
   L_FLOAT           pBRHCorner[2]; 
   L_FLOAT           pTLHCorner[2]; 
   L_UINT16          nRet; 
 
   pDICOMELEMENT pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS) ; 
 
   memset(&TextObject, 0, sizeof(DICOMTEXTOBJECT)); 
 
   pAnchorPoint[0] = (L_FLOAT)1.188; 
   pAnchorPoint[1] = (L_FLOAT)1.188; 
 
   pBRHCorner[0] = (L_FLOAT)1.288; 
   pBRHCorner[1] = (L_FLOAT)1.288; 
 
   pTLHCorner[0] = (L_FLOAT)1.388; 
   pTLHCorner[1] = (L_FLOAT)1.388; 
 
   TextObject.bAnchorPointVisible = FALSE; 
   TextObject.pAnchorPoint = pAnchorPoint; 
   TextObject.pBRHCorner = pBRHCorner; 
   TextObject.pszTextValue = TEXT("Text Value updated"); 
   TextObject.pTLHCorner = pTLHCorner; 
   TextObject.uAnchorPointUnits = DICANN_UNIT_PIXEL; 
   TextObject.uBoundingBoxUnits = DICANN_UNIT_PIXEL; 
   TextObject.pszLayerName = TEXT("First Layer"); 
   TextObject.uTextJustification = DICANN_TEXT_LEFT; 
   TextObject.uStructSize = sizeof(DICOMTEXTOBJECT); 
 
   nRet = L_DicomSetTextObjectInfo(hPresStateDS,pGraphicAnnSQItem, 0, &TextObject);  
   if (nRet == DICOM_SUCCESS) 
   { 
      MessageBox( NULL,  
                  TEXT("Object has been successfully updated."), 
                  TEXT("Note"),  
                  MB_OK);  
   } 
   return nRet; 
}