Skip to main content

ChartControl.PaletteName Property

Gets or sets the name of the palette currently used to draw the chart’s series.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v22.1.UI.dll

NuGet Package: DevExpress.Win.Charts


public string PaletteName { get; set; }

Property Value

Type Description

A String value which represents the palette name.


Use the ChartControl.IndicatorsPaletteName property to define the palette used for indicators.

For more information, see Appearance Customization.


How to Apply a Palette to a Chart

This example demonstrates how to customize a chart’s appearance at runtime, via the ChartControl.AppearanceName, ChartControl.PaletteName and ChartControl.PaletteBaseColorNumber properties.

Note that you can define a separate palette for painting all indicators available in your chart, via the ChartControl.IndicatorsPaletteName property.

View Example

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...
private void Form1_Load(object sender, EventArgs e) {
    // Create an empty chart.
    ChartControl barChart = new ChartControl();

    // Create a series and add points to it.
    Series series1 = new Series("Bar Series", ViewType.Bar);
    series1.Points.Add(new SeriesPoint("A", new double[] { 10 }));
    series1.Points.Add(new SeriesPoint("B", new double[] { 12 }));
    series1.Points.Add(new SeriesPoint("C", new double[] { 14 }));
    series1.Points.Add(new SeriesPoint("D", new double[] { 17 }));

    // Create an indicator (e.g. Regression Line),
    // and add it to the series' collection.
    RegressionLine myLine = new RegressionLine(ValueLevel.Value);

    // Add the series to the chart.

    // Define the chart's appearance and palette.
    barChart.AppearanceName = "Dark";
    barChart.PaletteName = "Opulent";
    barChart.PaletteBaseColorNumber = 5;

    // Define a separate palette for the chart's indicators.
    barChart.IndicatorsPaletteName = "Default";

    // Add the chart to the form.
    barChart.Dock = DockStyle.Fill;

How to Create and Apply a Custom Palette to a Chart

You can also apply a custom palette to a chart:

  • Create a Palette object and use the Add method to populate the palette with colors.
  • Use the ChartControl.PaletteRepository.RegisterPalette method to register the palette in the chart control.
  • To apply the palette to the chart, assign the palette name to the ChartControl.PaletteName property.

The following example shows how to create a palette, register and apply it to a chart:

// Create a palette.
Palette palette = new Palette("Custom Palette");
// Register the palette.
// Assign the palette to the chart.
chartControl1.PaletteName = "Custom Palette";
See Also