Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Fundamentals
   [Collapse]Providing Data
    [Collapse]Providing Data
      Manually Create a Series
      Manually Add Points to a Series
      Specify Series Data Members
      Automatic Series Creation
      Integration with a Data Grid, Vertical Grid, Tree List or List Box via ControlRowSource
      Pivot Charting (Integration with a Pivot Grid Control)
      Series Customization
      Series Scale Types
      Data Aggregation
      Colorizer
    [Expand]Data Representation
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Additional Resources
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Colorizer

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:

Expanded Overview

The Colorizer is used to choose colors for chart series points automatically, and stores it using the SeriesPoint.Color property. This feature can be applied to the SeriesPoint class.

This can be useful, for example, for providing additional information using color.

Important

A colorizer cannot provide colors to aggregated series points if the Chart control aggregates its or series' data.

Perform the following steps before using this feature:

  1. 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.

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

  3. Determine which type of a colorizer an application should use:

    • 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 color data member values' range.

After you select a colorizer type, assign the selected colorizer type's object to the SeriesBase.Colorizer property, and customize the colorizer's settings. The sections below describe how to do this.

Note

A colorizer is used to color only markers for area and line series views.

Expanded Color Object Colorizer

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:

Note

This is the default colorizer.

Expanded Key-Color Colorizer

Perform the following steps to configure the key-color colorizer:

The following image demonstrates a bar chart colorized according to the country's region using the key-color colorizer:

Expanded Range 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.

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

  • 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.

    Note

    This property can only be changed programmatically.

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

How would you rate this topic?​​​​​​​