SeriesDataSourceColorizer Class

Colorizer that paints series with colors stored in a data source.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[TypeConverter(typeof(SeriesDataSourceColorizerTypeConverter))]
public class SeriesDataSourceColorizer :
    SeriesColorizerBase,
    IDataSourceColorizer,
    IBindingProvider,
    IDataSourceChangedEventHandlerProvider

VB.NET

<TypeConverter(GetType(SeriesDataSourceColorizerTypeConverter))>
Public Class SeriesDataSourceColorizer
    Inherits SeriesColorizerBase
    Implements IDataSourceColorizer,
               IBindingProvider,
               IDataSourceChangedEventHandlerProvider

Remarks

This colorizer uses data objects from a data source to paint series. These objects can be an integer representing an ARGB color, a string that is the color name or a System.Drawing.Color object.

Example

The code below shows how to customize the colorizer.

Important

The main data source mentioned in the code snippet is the series template’s data source.

The code snippet uses the following properties:

Property	Description
SeriesDataSourceColorizer.DataSource	Gets or sets the data source whose data items the colorizer uses to paint series.
SeriesDataSourceColorizer.SeriesKeyMember	Gets or sets the name of data member whose values represent colors in which the colorizer paints series.
SeriesDataSourceColorizer.SeriesColorMember	Gets or sets the name of a data member whose values are used as series identifiers.

C#

class Department {
    public String Name { get; set; }
    public Color Marker { get; set; }
}
// ...
chartControl.SeriesTemplate.SeriesColorizer = new SeriesDataSourceColorizer() {
    // The data source storing objects that contain a series's color.
    DataSource = new List<Department> {
        new Department { Name = "DevAV North", Marker = Color.FromArgb(0xE1, 0x83, 0x35)},
        new Department { Name = "DevAV Europe", Marker = Color.FromArgb(0x1E, 0x91, 0xD6)},
        new Department { Name = "DevAV Australia", Marker = Color.FromArgb(0x8F, 0xC9, 0x3A)},
    };
    // The name of the data member storing objects that should be equal to a series data member's values from the main data source.
    SeriesKeyMember = "Name",
    // The name of the data member that contains colors.
    SeriesColorMember = "Marker"
};

VB.NET

Class Department 
    Public Property Name As String
    Public Property Marker As Color
End Class
' ...
chartControl.SeriesTemplate.SeriesColorizer = New SeriesDataSourceColorizer With { _
    ' A data source containing series color.
    .DataSource = New List(Of Department ) From { _
        New Department With { .Name = "DevAV North", Marker = Color.FromArgb(0xE1, 0x83, 0x35)}, _
        New Department With { .Name = "DevAV Europe", Marker = Color.FromArgb(0x1E, 0x91, 0xD6)}, _
        New Department With { .Name = "DevAV Australia", Marker = Color.FromArgb(0x8F, 0xC9, 0x3A)} _
    }, _
    ' The name of the data member storing objects that should be equal to a series data member's values from the main data source.
    .SeriesKeyMember = "Name", _
    ' The name of the data member that contains a color.
    .SeriesColorMember = "Marker" _
}

Inheritance

Object

ChartElement

SeriesColorizerBase

SeriesDataSourceColorizer