[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Collapse]Chart Control
   [Expand]Product Information
   [Expand]Getting Started
    [Collapse]Creating Charts
     [Expand]2D Chart Types
     [Expand]3D Chart Types
     [Collapse]Providing Data
       Manually Create a Series
       Manually Add Points to a Series
       Specify Series Data Members
       Automatic Series Creation
       Customize a Series
       Series Scale Types
       Pivot Charting (Integration with a Pivot Grid Control)
     [Expand]Data Representation
     [Expand]Appearance Customization
    [Expand]Chart Elements
    [Expand]End-User Interaction
     Supported Browsers
     Adding a Web Chart
     Handling Client-side Scripts
     Medium Trust Support
     Web Farm and Web Gardens Support
   [Expand]Design-Time Features
   [Expand]Visual Elements
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


This document introduces 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.

Expanded Overview

The Colorizer is used to automatically choose colors for chart series points. This feature can be applied to the SeriesPoint class. The calculated color is stored using the SeriesPoint.Color property.

This can be useful for providing additional information using color.

Before using this feature, perform the following steps.

  1. Specify the Series.DataSource property and all data member properties required to build a chart.

    The colorizer allows you to provide colors for the series points provided from the data source using one of approaches that will be discussed later.

  2. Specify the name of a data member that determines the color of the series' SeriesBase.ColorDataMember property.

  3. Determine which kind of a colorizer should be used in an application.

    Currently, the following types are supported.

    • ColorObjectColorizer allows you to provide color data member values to the SeriesPoint.Color property if these values have the System.Drawing.Color type or a type that can be converted to a color (integer number or string).

    • KeyColorColorizer allows you to choose the color depending on color data member values used as key values.

    • RangeColorizer allows you to colorize points depending on the range that color data member values belong to.

After you select a colorizer type, assign an object of the selected colorizer type to the SeriesBase.Colorizer property. Then, you can customize the colorizer's settings. The sections below describe how this can be done.

Expanded Color Object Colorizer

This colorizer does not have properties that should be specified before you use this colorizer. The following image demonstrates the data colorized using one of the national colors stored in a data source.


This colorizer is used by default.

Expanded Key-Color Colorizer

To configure the key-color colorizer, perform the following steps.

The following image demonstrates a bar chart colorized by the country's region using the key-color colorizer.

Expanded Range Colorizer

To configure the range colorizer, perform the following steps.

  • Fill the RangeColorizer.RangeStops collection. These values will form ranges that will be used to decide which color a series point should have.

  • Specify the ChartPaletteColorizerBase.Palette property if you want use a non-default palette to colorize your data.

  • In addition, it's possible to specify the RangeColorizer.ValueProvider property. This allows you to configure double-precision numeric values are provided, based on the color data series member values.


    This property can be changed only in code.

The following image demonstrates a bar chart colorized by the Happy Planet Index using the range colorizer.

Is this topic helpful?​​​​​​​