Text Pointer Annotation Object

Note: This topic is for Document/Medical only.

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.

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 L_AnnSetPoints for more details. Other applicable properties have the following defaults, which you can change:

Visible

Defaults to FALSE. It can be changed using the L_AnnSetVisible function.

Selected

Defaults to FALSE. It can be changed using the L_AnnSetSelected function.

Name

Defaults to an empty string. It can be changed using the L_AnnSetNameOptions function.

Line width

Defaults to 0.75 points. It can be changed using the L_AnnSetLineWidth 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 L_AnnSetLineStyle function.

ROP2 code

Defaults to ANNROP2_COPY. It can be changed using the L_AnnSetROP2 function.

Fill mode

Defaults to transparent. It can be changed using the L_AnnSetFillModeExt function. For version 14.5, before calling this function enable the alpha background fill mode by calling the L_AnnSetOptions function.

Foreground color

Defaults to red. It can be changed using the L_AnnSetForeColor function.

Background color

Defaults to white. It can be changed using the L_AnnSetBackColor function. The default does not affect highlight, redaction, or note objects.

Font size

Defaults to 10 point, translated with a scaling factor of 1. It can be changed using the L_AnnSetFontSize function.

Font underline

Defaults to FALSE. It can be changed using the L_AnnSetFontUnderline function.

Font strikethrough

Defaults to FALSE. It can be changed using the L_AnnSetFontStrikeThrough function.

Font italic

Defaults to FALSE. It can be changed using the L_AnnSetFontItalic function.

Font bold

Defaults to FALSE. It can be changed using the L_AnnSetFontBold function.

Font name

Defaults to "Arial". It can be changed using the L_AnnSetFontName function.

Text

Defaults to "AaBbYyZz". It can be changed using the L_AnnSetText function.

Text Displayed*

Defaults to Show text. It can be changed using L_AnnSetTextOptions.

Text Color*

Defaults to red (RGB(255,0,0). It can be changed using L_AnnSetTextOptions.

Text Alignment

Defaults to left alignment. It can be changed using the L_AnnSetTextAlign function.

Text Rotate

Defaults to no rotation. It can be changed using the L_AnnSetTextRotate function.

Text Pointer

The pointer part of the text pointer does not move when the object moves. It can be changed using the L_AnnSetTextPointerFixed function.

Expand Tokens

Defaults to expand tokens. It can be changed using the L_AnnSetTextExpandTokens function.

Fixed State

Defaults to not fixed. It can be changed using the L_AnnSetFixed function.

Hyperlink

Defaults to None. It can be changed using the L_AnnSetHyperlink function.

Tag (identifier)

Defaults to 0. It can be changed using the L_AnnSetTag function.

Window handle

Defaults to NULL or the handle inherited from the container. It can be changed for all objects using the L_AnnSetWnd function.

User mode

Defaults to design mode or the mode inherited from the container. It can be changed for all objects using the L_AnnSetUserMode function.

Fixed State

Defaults to not fixed. It can be changed using the L_AnnSetFixed function.

* Note that in version 14.5, these features must be enabled using the L_AnnSetOptions function.

Related topics:

image\sqrblit.gif Implementing Annotations.

image\sqrblit.gif Types of Annotations.

image\sqrblit.gif Low-Level Coordinate System for Annotations.

image\sqrblit.gif Annotation Objects - Automated Features

image\sqrblit.gif Using Annotation Bitmap Objects