LDicomDS::SetTextObjectInfo

#include "Ltdic.h"

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

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT uTextObjectIndex;

/* text annotation object index */

pDICOMTEXTOBJECT pTextObject;

/* pointer to the text annotation object attributes structure */

Updates the attributes of a text annotation object.

Parameter

Description

pGraphicAnnSQItem

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

uTextObjectIndex

Index of the text annotation object to be updated

pTextObject

Structure containing the text annotation object attributes.

Returns

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

See Also

Functions:

LDicomDS::FindFirstGraphicAnnSQItem, LDicomDS::CreateGraphicAnnSQItem, LDicomDS::CreateTextObject, LDicomDS::RemoveTextObject, LDicomDS::GetTextObjectInfo, LDicomDS::GetTextObjectCount, LDicomDS::RemoveAllTextObjects, LDicomDS::GetTextObjElement, LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, LDicomDS::ConvertDicomAnnObjToLEADAnnObj, Class Members

Topics:

Working with DICOM Annotations

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;
}