ChartControlBase.Palette Property

Gets or sets the palette which is used to draw the chart’s series.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Charts, DevExpress.Wpf.Charts

Declaration

C#

public Palette Palette { get; set; }

VB.NET

Public Property Palette As Palette

Property Value

Type	Description
Palette	A Palette class descendant object that represents the palette with colors.

Remarks

The Palette property defines colors for series points. It can be set either to one of the standard palettes, or to a CustomPalette object. A custom palette’s colors are stored in the ColorCollection, which is available using the CustomPalette.Colors property.

The name of the currently selected palette can be accessed using the DXChartsPalette.PaletteName property. If some of the default palette colors were manually changed, you can obtain the currently used set of colors using the ChartControlBase.Palette property.

For more information, refer to Chart Themes and Palettes.

Example

This example demonstrates how to change the series point colors by using a custom palette. To do this, a CustomPalette is added to the chart’s ChartControlBase.Palette. And, custom colors are specified via the CustomPalette.Colors property.

View Example

Window1.xaml

<dxc:ChartControl.Palette>
    <dxc:CustomPalette>
        <dxc:CustomPalette.Colors>
            <Color>Blue</Color>
            <Color>Yellow</Color>
            <Color>Magenta</Color>
        </dxc:CustomPalette.Colors>
    </dxc:CustomPalette>
</dxc:ChartControl.Palette>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Palette property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-invoke-the-chart-designer-at-runtime-t254238/CS/ChartDesignerRuntime/MainWindow.xaml#L39

</dxc:ChartControl.Titles>
<dxc:ChartControl.Palette>
    <dxc:Office2013Palette/>

how-to-customize-annotation-content-t380028/CS/AnnotationExample/MainWindow.xaml#L23

              CrosshairEnabled="False">
<dxc:ChartControl.Palette>
    <dxc:Office2013Palette/>

how-to-add-a-custom-legend-item-to-a-legend-t377606/CS/CustomLegendItemSample/MainWindow.xaml#L19

<dxc:ChartControl HorizontalAlignment="Left" VerticalAlignment="Top">
    <dxc:ChartControl.Palette>
        <dxc:Office2013Palette/>

how-to-add-a-legend-title-to-a-legend-t377595/CS/LegendTitleSample/MainWindow.xaml#L15

<dxc:ChartControl>
    <dxc:ChartControl.Palette>
        <dxc:Office2013Palette/>

how-to-anchor-annotations-to-various-points-t378313/CS/AnnotationExample/MainWindow.xaml#L18

              CrosshairEnabled="False">
<dxc:ChartControl.Palette>
    <dxc:Office2013Palette/>

C#

how-to-provide-a-custom-tooltip-for-a-series-point-e4083/CS/ToolTipPointTemplate/MainWindow.xaml.cs#L62

int colorNumber = e.Series.Points.IndexOf(e.SeriesPoint);
Color seriesColor = e.ChartControl.Palette[colorNumber];
toolTipData.SeriesBrush = new SolidColorBrush(seriesColor);

VB.NET

how-to-provide-a-custom-tooltip-for-a-series-point-e4083/VB/ToolTipPointTemplate/MainWindow.xaml.vb#L65

Dim colorNumber As Integer = e.Series.Points.IndexOf(e.SeriesPoint)
Dim seriesColor As Color = e.ChartControl.Palette(colorNumber)
toolTipData.SeriesBrush = New SolidColorBrush(seriesColor)