Hot Spot Tool

(Document and Medical Imaging toolkits)

The hot spot annotation object is a rectangle that can be activated for an application-defined purpose. In design mode, the rectangle contains a scaled image. Click and drag to specify the rectangle. Holding down the Shift key while drawing the hotspot will make the hotspot annotation square. In run mode, the object is transparent, but the mouse pointer changes to a hand when it is over the object. Clicking on the hot spot sends a WM_LTANNEVENT message that indicates an activation event. Code can be added to process the event. (The example program merely pops up a message box.)

In design mode, click on the object with the right mouse button to do the following:

• Undo the last user action.

• Cut or copy the object to the clipboard.

• Delete the object.

• Select all objects.

• Bring the object to the front or send it to the back.

• Lock and unlock annotation objects. See Password Dialog Box for Annotations.

• Change the Name properties. See Name Dialog Box for Annotations.

• Select a metafile to load into the stamp. See Stamp Metafile Dialog Box for Annotations.

• Change the fixed properties. See Fixed Dialog Box for Annotations.

• Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks.

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

For low-level implementation details, refer to Hot Spot Annotation Object.