Back to Devexpress

SeriesKeyColorColorizer Class

corelibraries-devexpress-dot-xtracharts-ee04ea5b.md

latest3.6 KB
Original Source

SeriesKeyColorColorizer Class

The colorizer that paints series in colors assigned to series keys, that are commonly series data member unique values.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
public class SeriesKeyColorColorizer :
    SeriesColorizerBase,
    IPaletteProvider,
    IPaletteRepositoryHolder,
    ISupportPropertyChanged
vb
Public Class SeriesKeyColorColorizer
    Inherits SeriesColorizerBase
    Implements IPaletteProvider,
               IPaletteRepositoryHolder,
               ISupportPropertyChanged

Remarks

When the colorizer starts painting series and its SeriesKeyColorColorizer.Keys collection is empty, the colorizer fills this collection using the unique series data member values.

Example

The following code demonstrates how to configure the colorizer and uses the properties below:

PropertyDescription
SeriesKeyColorColorizer.PaletteNameGets or sets the name of the palette whose colors the colorizer assigns to series.
SeriesKeyColorColorizer.KeysReturns the collection of keys that the colorizer uses to assign colors to series.
SeriesKeyColorColorizer.KeyProviderGets or sets the object that converts series data member values into series color keys.
csharp
SeriesKeyColorColorizer colorizer = new SeriesKeyColorColorizer() {
    // The colorizer uses the specified palette's colors.
    PaletteName = "Office2013",
    // The custom key provider that the colorizer uses 
    // to convert the series data member's value to another object.
    KeyProvider = new CustomKeyProvider()
};
// Keys that colorizer assigns to its palette's colors to create key-color pairs.
// The first key forms a pair with the first color, the second key with the second color, etc.
colorizer.Keys.AddRange(new object[]{"One", "Two", "Three"});
chartControl.SeriesTemplate.SeriesColorizer = colorizer;
vb
Dim colorizer As SeriesKeyColorColorizer = New SeriesKeyColorColorizer() With { _
    ' The colorizer uses the specified palette's colors.
    .PaletteName = "Office2013", _
    ' The custom key provider that the colorizer uses 
    ' to convert the series data member's value to another object.
    .KeyProvider = new CustomKeyProvider() _
}
' Keys that colorizer assigns to its palette's colors to create key-color pairs.
' The first key forms a pair with the first color, the second key with the second color, etc.
colorizer.Keys.AddRange(new object[]{"One", "Two", "Three"})
chartControl.SeriesTemplate.SeriesColorizer = colorizer

Inheritance

Object ChartElement SeriesColorizerBase SeriesKeyColorColorizer

See Also

SeriesKeyColorColorizer Members

DevExpress.XtraCharts Namespace