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