Highlighting Features

Chart FX supports Highlighting features that improve end users readability by allowing them to select chart elements in which to focus attention. This analytic tool allows users to easily discover values in the chart. There are several scenarios in which this is very useful, for example when a large number of points are visible in the chart area. Providing this feature in the chart allows end users to highlight and discover points. When an item is highlighted in a chart, the other Chart FX tools visible also reflect the action.

Note: Highlighting features are available only for active charts (.NET or ActiveX).

By default, when only a single series is plotted in a chart and a point is highlighted, that point will retain the "highlight" status. All other series will be dimmed while the highlighted point is slightly accentuated. When there are multiple series in a chart and a user highlights a chart, the entire series is highlighted, while all other series are dimmed.

This default behavior may be easily customized; for example, instead of the default dimming action of non-selected points, developers could programmatically configure non-selected points not to change and only the selected or highlighted element display highlighted attributes.

Setting colors, styles, highlight speed, grid attributes, if enabled and much more are all possible using the HighlightSettings, HighlightGridSettings, HighlightToolSettings and HighlightEventArgs classes.

Important Note: The Highlight feature is ONLY functional when generating active charts, such as a.NET Client Control or an ActiveX chart. When rendering images in web applications, this feature is not available.HighlightSettings Class


chart1.getHighlight().setDimmed(false);

This class is the core class for the highlighting feature. Using the supported members, you can turn the highlight feature on and off (Enabled), highlight chart items programmatically, add additional code to highlight processing (using OnHighlight event), clear highlights, control how points will be painted when highlighted and much more. The PointAttributes property returns a PointAttributes object. Using this object, you can control how points will be displayed in the chart when highlighted.

HighlightGridSettings Class

This class is used for customization of the DataEditor when a highligh event occurs. Setting colors for data cells, border colors, text color, etc.

HighlightToolSettings Class

This class is used to instruct how the other chart tools will interpret a highlight event; whether the tool will be affected by a highlight event or not.

HighlightEventArgs Class

This class supports the properties available to the developer during the OnHighlight Event.