Visit Gigasoft's Web Site
 ProEssentials v9 Help

HOTSPOTDATA

This structure holds parameters defining the most current hot-spot event. The ProEssentials reset this structure every time a WM_LBUTTONDOWN or WM_RBUTTONDOWN message is received.

 

 

typedef struct tagHOTSPOTDATA

{

  RECT rectHotSpot;

  UINT nHotSpotType;

  UINT w1;

  UINT w2;

} HOTSPOTDATA;

 

Parameter

Description

rectHotSpot

This parameter can be ignored. It is used internally.

nHotSpotType

This parameter defines the type of hot-spot.

PEHS_NONE (0)

PEHS_SUBSET (1) w1 = subset index

PEHS_POINT (2) w1 = point index**

PEHS_GRAPH(3) see below

PEHS_TABLE (4) w1 = subset index, w2 = point index

PEHS_DATAPOINT (5) w1 = subset index, w2 = point index

PEHS_GRAPHANNOTATION (6) w1 = annotation index

PEHS_XAXISANNOTATION (7) w1 = annotation index

PEHS_YAXISANNOTATION (8) w1 = annotation index

PEHS_HORZLINEANNOTATION (9) w1 = annotation index

PEHS_VERTLINEANNOTATION (10) w1 = annotation index

PEHS_MAINTITLE (11)

PEHS_SUBTITLE (12)

PEHS_MULTISUBTITLE (13) w1 = index, w2 = 0-left, 1-center, 2-right

PEHS_MULTIBOTTOMTITLE (14) w1 = index, w2 = 0-left, 1-center, 2-right

PEHS_YAXISLABEL (15) w1 = axis, w2 = 0-left, 1-right

PEHS_XAXISLABEL (16) w1 = 0-bottom, 1-top

PEHS_YAXIS (17) w1 = axis, w2 = 0-left, 1-right

PEHS_XAXIS (18) w1 = 0-bottom, 1-top

PEHS_YAXISGRIDNUMBER(19) 

PEHS_RYAXISGRIDNUMBER(20

PEHS_XAXISGRIDNUMBER(21)

PEHS_TXAXISGRIDNUMBER(22)

PEHS_TABLEANNOTATION(23) [23 - 42]  w1=Row:   w2 =Column

PEHS_TABLEANNOTATION59(82) [23 - 42]  w1=Row:   w2 =Column

PEHS_ZAXISGRIDNUMBER 83

 

Comments

The SDK developer will recognize Hot-Spots events by responding to the PEWN_CLICKED or PEWN_DBLCLICKED notification messages via WM_COMMAND. In response to a WM_COMMAND with one of the above ProEssentials notification message, use PEvget to receive the current HOTSPOTDATA structure. If nHotSpotType does not equal PEHS_NONE, then a Hot-Spot event has occurred. The developer then uses w1 and w2 to further define what type of event has occurred.

 

In the case of a PEHS_GRAPH, PEHS_YAXIS and PEHS_XAXIS, the developer must also use PEP_structGRAPHLOC to retrieve the GRAPHLOC structure which stores the coordinates where the user clicked.

 

A PEHS_POINT event for the Pie Chart Object will also give the subset index in the w2 structure member.

 

Above where w1 = axis, this is the zero based axis index and is only used if MultiAxesSubsets is implemented.

 

See Also: PEP_structHOTSPOTDATA, PEgethotspot, AllowDataHotSpots