Series.Palette Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the color palette of a Series object.
public:
property System::Windows::Forms::DataVisualization::Charting::ChartColorPalette Palette { System::Windows::Forms::DataVisualization::Charting::ChartColorPalette get(); void set(System::Windows::Forms::DataVisualization::Charting::ChartColorPalette value); };[System.ComponentModel.Bindable(true)]
public System.Windows.Forms.DataVisualization.Charting.ChartColorPalette Palette { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Palette : System.Windows.Forms.DataVisualization.Charting.ChartColorPalette with get, setPublic Property Palette As ChartColorPaletteProperty Value
An ChartColorPalette enumeration value that determines the palette for the data series.
- Attributes
Remarks
A palette is used to automatically assign colors to data elements if the data points themselves do not have colors assigned to them and if the data Series object that the data points belong to also does not have an assigned color.
If no series or data point colors are explicitly specified, the colors used depend on the chart type and the Chart control palette or Series palette, if one is specified. See the table below for further details:
| Chart Type | Series Palette Used? | Colors Displayed by Data Points |
|---|---|---|
| Any shape chart (for example, Pie and Doughnut charts) | No | First available colors used from Chart control palette. One color per data point. |
| All charts except shape charts. | No | First available colors from Chart control palette. One color per data series. |
| Any shape chart (for example, Pie and Doughnut charts) | Yes | First available colors used from Series palette. One color per data point. |
| All charts except shape charts. | Yes | First available colors used from Series palette. One color per data series. |
This Palette property has precedence over the Palette property of the root Chart object, with respect to the display of data.
NOTE: If the Palette property for both the Chart and Series objects is set to None, and no color is assigned to the relevant data series/data points, the default palette "BrightPastel" or PaletteCustomColors is used.
