NotifyIM -- HotspotActivated

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

The NotifyIM -- HotspotActivated notification tells client applications that a hotspot from Imagenation 3.6 or later has been activated.

Type XTYP_ADVSTART or XTYP_ADVSTOP

Item Syntax NotifyIM -- HotspotActivated

Type XTYP_ADVDATA

Item Syntax NotifyIM -- HotspotActivated

Data Syntax (HWND:docwinID) (LYR:layerID) (XY:x y) (HID:hotspotID) (DATA)data

Parameter

Data type

Meaning

docwinID

DWORD

identifier of the window that contains the hotspot

layerID

DWORD

identifier of the layer that contains the hotspot

x y

WORD

position of the hotspot center. See Remarks.

hotspotID

WORD

identifier of the hotspot that was activated

data

string

hotspot data, non-quoted

Remarks

The x y coordinates are given in the units defined by the SetHotspotNotifyUnits transaction. Units other than proportional, 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.

Release information

Added in Release 4.00.

Modified in Release 5.10 to support coordinates other than display coordinates.

See also

Activating hotspots

Sample code: Requesting and retrieving hotspot activations