Freehand Hot Spot Annotation Object

Note:

This topic is for Document/Medical only.

The freehand hot spot annotation object (ANNOBJECT_FREEHANDHOTSPOT) is an array of points that create a sequence of joined lines. With the automated functions, in design mode, each line segment is formed with a mouse move event when the left button is down, and the object is completed on a mouse up event. In run mode, the object is transparent, but the mouse pointer changes to a hand when it is over the object. Clicking on the button triggers an AnnClicked event.

You cannot flip, reverse, or rotate a hot spot. If you flip, reverse, or rotate a container that includes a hot spot, the object will move to the new position, but will retain its orientation.

The points can be changed using the AnnGetPointX method, AnnGetPointY method and AnnSetPoints method.

With low-level functions, you must define the size and position of the rectangle. Other applicable properties have the following defaults, which you can change:

Visible

Defaults to FALSE. It can be changed using the AnnSetVisible method.

Selected

Defaults to FALSE. It can be changed using the AnnSetSelected method.

Name

Defaults to an empty string. It can be changed using the AnnSetNameOptions method.

Line width

Defaults to 0.75 points. It can be changed using the AnnSetLineWidth method. (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 AnnSetLineStyle method.

ROP2 code

Defaults to Copy. It can be changed using the AnnSetROP2 method.

Nodes

Defaults to displaying all nodes. It can be changed using the AnnSetNodes method.

Metafile

Defaults to a campfire graphic. It can be changed using the AnnSetMetafile method.

Fixed State

Defaults to not fixed. It can be changed using the AnnFixed property.

Hyperlink

Defaults to None. It can be changed using the AnnSetHyperlinkString method.

Tag (identifier)

Defaults to 0. It can be changed using the AnnSetTag method.

Window handle

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

User mode

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

For information on flipping, reversing or rotating annotation objects, refer to Flipping, Reversing and Rotating Annotation Objects.

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 Displaying and Manipulating Annotation Objects

image\sqrblit.gif Using Annotation Object Bitmaps