CChartViewer.setImageMap

Sets the image map that defines the hot spots on the chart image.

CChartViewer expects the image map to be in HTML image map format. BaseChart.getHTMLImageMap can be used to automatically generate image maps for charts.

You can include custom hot spots in the chart by appending HTML <AREA> tags to the image map. For example, you can add a custom icon to the chart and make it clickable by creating an HTML <AREA> tag for the icon and append it to the image map.

CChartViewer will process the various attributes of the HTML <AREA> tags as follows:

Attribute	Description
coords	This attribute defines the position and shape of the hot spot.
href	The URL specified in this attribute will become the attributes of the hot spot. The path portion of the URL will become the path attribute, and the attributes/values of the query parameters will become the attributes/values of the hot spot. If the path attribute is not empty and does not start with the '~', the mouse cursor will change to the hand cursor when it is over the hot spot.
title	The title attribute defines the tool tip to display when the mouse moves over and stops on the hot spot. CChartViewer supports both standard tooltips and CDML tooltips. Please refer to CChartViewer.setCDMLToolTipPrefix for more details.

The ImageMapHandler object, accessible via CChartViewer.getImageMapHandler, can be used to determine if the mouse cursor is over a hot spot and retrieve its attributes.