LDicomDS::CreateTextObject

Summary

Creates a new text annotation object.

Syntax

#include "Ltdic.h"

L_UINT16 LDicomDS::CreateTextObject(pGraphicAnnSQItem, pTextObject, bCheckLayer=FALSE)

Parameters

pDICOMELEMENT pGraphicAnnSQItem

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

pDICOMTEXTOBJECT pTextObject

Pointer to the text object attributes structure.

L_BOOL bCheckLayer

Flag that indicates whether to verify that the layer (to which the text object will be added) exists or not.

Value Meaning
TRUE Check if the layer exists before adding the object. If it does not existed, then return an error.
FALSE Add the new object without checking the existence of the layer.

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.

When the parameter bCheckLayer is set to TRUE, then the function checks if the layer specified in the member variable pszLayerName exists or not. If it does not exist, an error will be returned.

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Functions

Topics

Example

L_INT LDicomDS_CreateTextObjectExample(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.1;  
   pAnchorPoint[1] = (L_FLOAT)1.1;  
 
   pBRHCorner[0] = (L_FLOAT)521.251343;  
   pBRHCorner[1] = (L_FLOAT)328.190216;  
 
   pTLHCorner[0] = (L_FLOAT)466.642242;  
   pTLHCorner[1] = (L_FLOAT)300.443268;  
 
   TextObject.bAnchorPointVisible = FALSE;  
 
   TextObject.pAnchorPoint = NULL;  
 
   TextObject.pBRHCorner = pBRHCorner;  
 
   TextObject.pszTextValue = TEXT("Text Value 1"); 
 
   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.CreateTextObject(pGraphicAnnSQItem, &TextObject);  
 
   if (nRet == DICOM_SUCCESS)  
 
   { 
 
      MessageBox( NULL,  
                  TEXT("Object has been successfully created."),  
                  TEXT("Note"),  
                  MB_OK);  
 
   } 
 
   return nRet; 
 
} 
Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C++ Class Library Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.