LEADTOOLS Raster Imaging C++ Class Library Help > LEADTOOLS Raster Imaging Features > Annotations > Annotation Objects > Objects > Text Annotation Object |
The text annotation object (ANNOBJECT_TEXT) is a rectangle containing a character string with font properties. The text will wrap on word breaks within the object's specified rectangle. With the automated functions, the user clicks and drags to specify the rectangle in the current window. A dialog box then lets the user enter the text.
The class for Text Annotation objects is LAnnText.
You cannot flip or reverse a text object. If you flip or reverse a container that includes a text object, the text will move to the new position, but will retain its orientation.
For information on flipping, reversing or rotating annotation objects, refer to Flipping, Reversing and Rotating Annotation Objects.
With low-level functions, you must specify the rectangle that contains the text. Other applicable properties have the following defaults, which you can change:
Visible |
Defaults to FALSE. It can be changed using the LAnnotation::SetVisible function. |
Selected |
Defaults to FALSE. It can be changed using the LAnnotation::SetSelected function. |
Name |
Defaults to an empty string. It can be changed using the LAnnotation::SetNameOptions function. |
Fill mode |
Defaults to transparent. It can be changed using the LAnnotation::SetFillMode function. |
Foreground color |
Defaults to red. It can be changed using the LAnnotation::SetForeColor function. |
Background color |
Defaults to white. It can be changed using the LAnnXXX::SetBackColor function. |
Font size |
Defaults to 10 point, translated with a scaling factor of 1. It can be changed using the LAnnXXX::SetFontSize function. |
Font underline |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontUnderline function. |
Font strikethrough |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontStrikethrough function. |
Font italic |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontItalic function. |
Font bold |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontBold function. |
Font name |
Defaults to "Arial". It can be changed using the LAnnXXX::SetFontName function. |
Text |
Defaults to "AaBbYyZz". It can be changed using the LAnnText::SetText function. |
Text Displayed* |
Defaults to Show text. It can be changed using LAnnotation::SetTextOptions. |
Text Color* |
Defaults to red (RGB(255,0,0). It can be changed using LAnnotation::SetTextOptions. |
Text Border* |
Defaults to show the Border. It can be changed using LAnnotation::SetTextOptions. |
Text Alignment. |
Defaults to left alignment. It can be changed using the LAnnText::SetTextAlign function. |
Expand Tokens |
Defaults to expand tokens. It can be changed using the LAnnAutomation::SetTextExpandTokens function. |
Fixed State |
Defaults to not fixed. It can be changed using LAnnXXX::SetFixed function. |
Hyperlink |
Defaults to ANNLINK_NONE. It can be changed using the LAnnotation::SetHyperlink function. |
Tag (identifier) |
Defaults to 0. It can be changed using the LAnnotation::SetTag function. |
Window handle |
Defaults to NULL or the handle inherited from the container. |
User mode |
Defaults to design mode or the mode inherited from the container. |
* These features must be enabled using the LAnnotation::SetOptions function.
Related topics:
Low-Level Coordinate System for Annotations.