SetHotspotNotifyUnits

image\bltlrgss.gif Editions  image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The SetHotspotNotifyUnits transaction sets the coordinate units used by the hotspot notifications (NotifyIM -- HotspotActivated, NotifyIM -- HotspotDeleted, NotifyIM -- HotspotHighlighted, and NotifyIM -- HotspotPlaced). All hotspot notifications must use the same units. You cannot set different units for individual hotspot notifications.

Type XTYP_EXECUTE

Syntax [SetHotspotNotifyUnits(units)]

Parameter

Data type

Values

Meaning

units

WORD

units used by the hotspot notifications:

 

 

0

proportional. See Remarks.

 

 

1

inches

 

 

2

cm

 

 

3

pixels

 

 

4

feet

 

 

5

mm

 

 

6

m

 

 

9 | 10 | 11

custom 1 | 2 | 3. See Remarks.

Remarks

When units other than proportional are used, the hotspot notifications return values in physical space--the distance of the hotspot center from the 0,0 point on the page. Because the values must be integers rather than floating point values, they are multiplied by 100,000 before they are returned.

To be used, custom units must be defined in Imagenation (through the Units category or dialog box).

Release information

Added in Release 5.10.

See also

Using hotspots