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
	How to Disable the Automatic Loading of the default DICOM IOD Table

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