Text Pointer Annotation Object

The Text Pointer annotation object (ANNOBJECT_TEXTPOINTER) is a rectangle with a line that starts from one of the four corners. The other endpoint of the line can be moved to point to anything on the underlying image. The rectangle contains 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 drag to specify the rectangle in the current window. After letting up on the mouse button, the rectangle is specified. Moving the mouse now specifies the line, with a final mouse click defining the line.

You can flip or reverse a text pointer object, but you cannot rotate it. If you flip or reverse the text pointer object, the text orientation does not change. To change the text orientation, see Text Dialog Box for Annotations.

To change the text orientation of a Text Pointer object, see Text Dialog Box for Annotations.

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, and the pointer endpoint of the line. See LAnnPoint::SetPoints for more details. Other applicable properties have the following defaults, which you can change:

Property Default value
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.
Line width Defaults to 0.75 points. It can be changed using the LAnnAutomation::SetLineWidth function. (Note that when displayed, the line must have a minimum width of 1 pixel.)
Line style Defaults to solid. It can be changed using the LAnnAutomation::SetLineStyle function.
ROP2 code Defaults to ANNROP2_COPY. It can be changed using the LAnnotation::SetROP2 function.
Fill mode Defaults to transparent. It can be changed using the LAnnotation::SetFillMode function. Before calling this function enable the alpha background fill mode by calling the LAnnotation::SetOptions 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 LAnnotation::SetBackColor function.
Font size Defaults to 10 point, translated with a scaling factor of 1. It can be changed using the LAnnotation::SetFontSize function.
Font underline Defaults to FALSE. It can be changed using the LAnnotation::SetFontUnderline function.
Font strikethrough Defaults to FALSE. It can be changed using the LAnnotation::SetFontStrikethrough function.
Font italic Defaults to FALSE. It can be changed using the LAnnotation::SetFontItalic function.
Font bold Defaults to FALSE. It can be changed using the LAnnotation::SetFontBold function.
Font name Defaults to "Arial". It can be changed using the LAnnotation::SetFontName function.
Text Defaults to "AaBbYyZz". It can be changed using the LAnnAutomation::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 Alignment Defaults to left alignment. It can be changed using the LAnnTextPointer::SetTextAlign function.
Text Rotate Defaults to no rotation. It can be changed using the LAnnTextPointer::SetTextRotate function.
Text Pointer The pointer part of the text pointer does not move when the object moves. It can be changed using the LAnnTextPointer::SetTextPointerFixed 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 the LAnnTextPointer::SetFixed function.
Hyperlink Defaults to 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. It can be changed for all objects using the LAnnContainer::SetWnd function.
User mode Defaults to design mode or the mode inherited from the container. It can be changed for all objects using the LAnnContainer::SetUserMode function.
* These features must be enabled using the LAnnotation::SetOptions function.

See Also

Help Version 21.0.2021.4.8
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help