This document describes the Chart Colorizer, lists colorizer types, and explains how to create a colorizer and customize its settings in a chart control.
The document consists of the following sections:
The Colorizer is used to choose colors for chart series points automatically, and stores it using the SeriesPoint.Brush property. This feature can be applied to the SeriesPoint class.
This can be useful, for example, for providing additional information using color.
When the Chart Control aggregates series data, the aggregated point has the color that mostly occurs on the aggregated interval.
Perform the following steps before using this feature:
Specify the Series.DataSource property, if necessary, and all data member properties required to build a chart.
The colorizer allows you to provide colors for the series points the data source provides using one of the approaches that is discussed later.
Specify the name of a data member that determines the color of the series' Series.ColorDataMember property.
Determine which type of a colorizer an application should use:
After you select a colorizer type, assign the selected colorizer type's object to the Series.Colorizer property, and customize the colorizer's settings. The sections below describe how to do this.
A colorizer is used to color only point markers for line and area series views.
This colorizer does not require specifying properties before using it. The following image demonstrates data colorized using a national color stored in the data source:
This is the default colorizer.
Perform the following steps to configure the key-color colorizer:
Fill the KeyColorColorizer.Keys collection.
Specify the ChartPaletteColorizerBase.Palette property if you want to use a non-default palette to colorize your data.
It is also possible to configure the KeyColorColorizer.KeyProvider property that allows specifying how a color key is generated from a color data source member.
The following image demonstrates a bar chart colorized according to the country's region using the key-color colorizer:
Follow the steps below to configure the range colorizer.
Fill the RangeColorizer.RangeStops collection. These values form ranges that are used to determine which color a series point should have.
It is also possible to specify the RangeColorizer.ValueProvider property. This allows you to configure how to provide double-precision numeric values based on the color data series member values.
The following image demonstrates a bar chart colorized by the Happy Planet Index using the range colorizer: