In This Topic ▼

LDicomDS::SetTextObjectInfo

Summary

Updates the attributes of a text annotation object.

Syntax

#include "Ltdic.h"

L_UINT16 LDicomDS::SetTextObjectInfo(pGraphicAnnSQItem, uTextObjectIndex, pTextObject)

Parameters

pDICOMELEMENT pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0070,0001) 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
0	SUCCESS
>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

Example

L_INT LDicomDS_SetTextObjectInfoExample(LDicomDS& PresStateDS)  
 
{ 
   L_INT             nRet; 
   DICOMTEXTOBJECT   TextObject;  
   pDICOMELEMENT     pGraphicAnnSQItem = PresStateDS.FindFirstGraphicAnnSQItem() ;  
 
   memset(&TextObject, 0, sizeof(DICOMTEXTOBJECT));  
 
   L_FLOAT pAnchorPoint[2];  
   L_FLOAT pBRHCorner[2];  
   L_FLOAT pTLHCorner[2];  
 
   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 = PresStateDS.SetTextObjectInfo(pGraphicAnnSQItem, 0, &TextObject);  
 
   if (nRet == DICOM_SUCCESS)  
 
   { 
 
      MessageBox( NULL,  
                  TEXT("Object has been successfully updated."),  
                  TEXT("Note"),  
                  MB_OK);  
 
   } 
 
   return nRet; 
 
}