Hot Spot Annotation Object

Note:

This topic is for Document/Medical only.

The Hot Spot annotation object (ANNOBJECT_HOTSPOT) is a rectangle that can be activated for an application-defined purpose. With the automated functions, in design mode, the rectangle contains a scaled image. The user clicks and drags to specify the rectangle in the current window. 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 sends a WM_LTANNEVENT message that indicates an activation event.

The class for Hot Spot Annotation objects is LAnnHotSpot.

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 defining rectangle. Other applicable properties have the following defaults, which you can change:

Active state

Defaults to disabled. It can be changed using the LAnnotation::SetActiveState function.

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.

Metafile

Defaults to a campfire graphic. It can be changed using the LAnnHotSpot::SetMetafile function.

Fixed State

Defaults to not fixed. It can be changed using the 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. It can be changed for all objects using LAnnContainer::SetWnd.

User mode

Defaults to design mode or the mode inherited from the container. It can be changed for all objects using LAnnContainer::SetUserMode.

Related topics:

image\sqrblit.gif Implementing Annotations.

image\sqrblit.gif Types of Annotations.

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