LEADTOOLS DICOM C++ Class Library Help > LEADTOOLS DICOM Features > DICOM Annotations > Used Structures > DICOMTEXTOBJECT |
typedef struct tagDICOMTEXTOBJECT
{
L_UINT uStructSize;
L_TCHAR *pszLayerName;
L_TCHAR *pszTextValue;
L_FLOAT *pTLHCorner;
L_FLOAT *pBRHCorner;
L_UINT uBoundingBoxUnits;
L_UINT uTextJustification;
L_FLOAT *pAnchorPoint;
L_UINT uAnchorPointUnits;
L_BOOL bAnchorPointVisible;
} DICOMTEXTOBJECT, *pDICOMTEXTOBJECT;
The DICOMTEXTOBJECT describes the attributes of a "Text Annotation" object.
Member |
Description |
|
uStructSize |
The size of the structure (use sizeof (DICOMTEXTOBJECT)). |
|
pszLayerName |
Pointer to the "Graphic Layer" (0070,0002) attribute value in the "Graphic Annotation Sequence" (0070,0001) |
|
pszTextValue |
Pointer to the "Unformatted Text Value" (0070,0006) attribute value. |
|
pTLHCorner |
Pointer to the "Bounding Box Top Left Hand Corner" (0070,0010) attribute value. |
|
pBRHCorner |
Pointer to the "Bounding Box Bottom Right Hand Corner" (0070,0011) attribute value. |
|
uBoundingBoxUnits |
"Bounding Box Annotation Units" (0070,0003) attribute value. Enumerated values are: |
|
|
Value |
Meaning |
|
DICANN_UNIT_PIXEL |
[0x00000001] "PIXEL". |
|
DICANN_UNIT_DISPLAY |
[0x00000002] "DISPLAY" |
uTextJustification |
"Bounding Box Text Horizontal Justification" (0070,0012) attribute value. Enumerated values are: |
|
Value |
Meaning |
|
DICANN_TEXT_LEFT |
[0x00000000] "LEFT" |
|
DICANN_TEXT_RIGHT |
[0x00000001] "RIGHT". |
|
DICANN_TEXT_CENTER |
[0x00000002] "CENTER". |
pAnchorPoint |
Pointer to the "Anchor Point"(0070,0014) attribute value. |
uAnchorPointUnits |
"Anchor Point Annotation Units" (0070,0004) attribute value. Enumerated values are: |
|
Value |
Meaning |
|
DICANN_UNIT_PIXEL |
[0x00000001] "PIXEL". |
|
DICANN_UNIT_DISPLAY |
[0x00000002] "DISPLAY". |
bAnchorPointVisible |
"Anchor Point Visibility" (0070,0015) attribute value. Possible values are: |
|
Value |
Meaning |
|
TRUE |
"Y" |
|
FALSE |
"N" |
Comments
The members of this structure are based on some of the attributes of the "Graphic Annotation Module", please see "Graphic Annotation Module Attributes" in the DICOM standard for more details.
Special note about the following members: pszLayerName, pszTextValue, pTLHCorner, pBRHCorner and pAnchorPoint:
When you call a function, which updates this structure (ex. LDicomDS::GetTextObjectInfo), LEADTOOLS will fill these members with pointers to the internal memory, which LEADTOOLS manages. You must not free these pointers. When you call a function, which updates internal data from the structure you provide (ex. LDicomDS::SetTextObjectInfo), LEADTOOLS expects you to fill these members with pointers to memory that you have allocated and that you manage. You must free these pointers when they are no longer needed.
See Also
Functions: |
LDicomDS::CreateTextObject, LDicomDS::GetTextObjectInfo, LDicomDS::SetTextObjectInfo. |
Topics: |