ChartObject.Style Property

Gets or sets the style to be applied to the chart.

Namespace: DevExpress.Spreadsheet.Charts

Assembly: DevExpress.Spreadsheet.v19.1.Core.dll

Declaration

C#

ChartStyle Style { get; set; }

VB.NET

Property Style As ChartStyle

Property Value

Type	Description
ChartStyle	A ChartStyle enumeration value specifying the chart style.

Available values:

Show 48 items

Name	Description
Gray	Specifies the monochromatic chart style that applies different shades of the first dark color defined by the document’s theme to each data series.
GrayOutline	Specifies the monochromatic chart style that applies different shades of the first dark color defined by the document’s theme to each data series and specifies shape outlines.
GrayGradient	Specifies the monochromatic chart style that applies different shades of the first dark color to each data series with a gradient effect defined by the document’s theme.
GrayBevel	Specifies the monochromatic chart style that applies different shades of the first dark color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
GrayArea	Specifies the monochromatic chart style that applies different shades of the first dark color defined by the document’s theme to each data series and specifies 20% tint of this color as the background color of the plot area.
GrayDark	Specifies the monochromatic chart style that applies different shades of the first dark color defined by the document’s theme to each data series and uses this color to specify the heavy background fill of the chart area.
Color	Specifies the colorful chart style that applies one of six accent colors defined by the document’s theme to each data series.
ColorOutline	Specifies the colorful chart style that applies one of six accent colors defined by the document’s theme to each data series and specifies shape outlines.
ColorGradient	Specifies the colorful chart style that applies one of six accent colors to each data series with a gradient effect defined by the document’s theme.
ColorBevel	Specifies the colorful chart style that applies one of six accent colors defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
ColorArea	Specifies the colorful chart style that applies one of six accent colors to each data series and specifies 20% tint of the first dark color of the document’s theme as the background color of the plot area.
ColorDark	Specifies the colorful chart style that applies one of six accent colors and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.
Accent1	Specifies the monochromatic chart style that applies different shades of Accent1 color defined by the document’s theme to each data series.
Accent1Outline	Specifies the monochromatic chart style that applies different shades of Accent1 color defined by the document’s theme to each data series and specifies shape outlines.
Accent1Gradient	Specifies the monochromatic chart style that applies different shades of Accent1 color to each data series with a gradient effect defined by the document’s theme.
Accent1Bevel	Specifies the monochromatic chart style that applies different shades of Accent1 color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
Accent1Area	Specifies the monochromatic chart style that applies different shades of Accent1 color defined by the document’s theme to each data series and specifies this color as the background color of the plot area.
Accent1Dark	Specifies the monochromatic chart style that applies different shades of Accent1 color and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.
Accent2	Specifies the monochromatic chart style that applies different shades of Accent2 color defined by the document’s theme to each data series.
Accent2Outline	Specifies the monochromatic chart style that applies different shades of Accent2 color defined by the document’s theme to each data series and specifies shape outlines.
Accent2Gradient	Specifies the monochromatic chart style that applies different shades of Accent2 color to each data series with a gradient effect defined by the document’s theme.
Accent2Bevel	Specifies the monochromatic chart style that applies different shades of Accent2 color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
Accent2Area	Specifies the monochromatic chart style that applies different shades of Accent2 color defined by the document’s theme to each data series and specifies this color as the background color of the plot area.
Accent2Dark	Specifies the monochromatic chart style that applies different shades of Accent2 color and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.
Accent3	Specifies the monochromatic chart style that applies different shades of Accent3 color defined by the document’s theme to each data series.
Accent3Outline	Specifies the monochromatic chart style that applies different shades of Accent3 color defined by the document’s theme to each data series and specifies shape outlines.
Accent3Gradient	Specifies the monochromatic chart style that applies different shades of Accent3 color to each data series with a gradient effect defined by the document’s theme.
Accent3Bevel	Specifies the monochromatic chart style that applies different shades of Accent3 color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
Accent3Area	Specifies the monochromatic chart style that applies different shades of Accent3 color defined by the document’s theme to each data series and specifies this color as the background color of the plot area.
Accent3Dark	Specifies the monochromatic chart style that applies different shades of Accent3 color and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.
Accent4	Specifies the monochromatic chart style that applies different shades of Accent4 color defined by the document’s theme to each data series.
Accent4Outline	Specifies the monochromatic chart style that applies different shades of Accent4 color defined by the document’s theme to each data series and specifies shape outlines.
Accent4Gradient	Specifies the monochromatic chart style that applies different shades of Accent4 color to each data series with a gradient effect defined by the document’s theme.
Accent4Bevel	Specifies the monochromatic chart style that applies different shades of Accent4 color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
Accent4Area	Specifies the monochromatic chart style that applies different shades of Accent4 color defined by the document’s theme to each data series and specifies this color as the background color of the plot area.
Accent4Dark	Specifies the monochromatic chart style that applies different shades of Accent4 color and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.
Accent5	Specifies the monochromatic chart style that applies different shades of Accent5 color defined by the document’s theme to each data series.
Accent5Outline	Specifies the monochromatic chart style that applies different shades of Accent5 color defined by the document’s theme to each data series and specifies shape outlines.
Accent5Gradient	Specifies the monochromatic chart style that applies different shades of Accent5 color to each data series with a gradient effect defined by the document’s theme.
Accent5Bevel	Specifies the monochromatic chart style that applies different shades of Accent5 color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
Accent5Area	Specifies the monochromatic chart style that applies different shades of Accent5 color defined by the document’s theme to each data series and specifies this color as the background color of the plot area.
Accent5Dark	Specifies the monochromatic chart style that applies different shades of Accent5 color and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.
Accent6	Specifies the monochromatic chart style that applies different shades of Accent6 color defined by the document’s theme to each data series.
Accent6Outline	Specifies the monochromatic chart style that applies different shades of Accent6 color defined by the document’s theme to each data series and specifies shape outlines.
Accent6Gradient	Specifies the monochromatic chart style that applies different shades of Accent6 color to each data series with a gradient effect defined by the document’s theme.
Accent6Bevel	Specifies the monochromatic chart style that applies different shades of Accent6 color defined by the document’s theme to each data series and specifies shape effects, like beveled edges and shadows.
Accent6Area	Specifies the monochromatic chart style that applies different shades of Accent6 color defined by the document’s theme to each data series and specifies this color as the background color of the plot area.
Accent6Dark	Specifies the monochromatic chart style that applies different shades of Accent6 color and shape effects to each data series and specifies the heavy background fill of the chart area using the first dark color of the document’s theme.

Remarks

Use the Style property to apply one of the prebuilt styles defined by the ChartStyle enumeration members to the existing chart. Applying a style to the chart removes your custom formatting and sets the standard formatting determined by the selected style. Each style specifies the color of the data series, sets the chart’s background fill and applies different shape effects and outlines to the chart.

The visual appearance of the chart to which the predefined style is applied depends on the current theme specified in a workbook. Every document’s theme has a palette of colors which are used to set the colors of the chart. For example, you can select a colorful chart style which applies to each series one of the six accent colors, or you can specify a monochromatic design, which uses different shades of the same color for each series. The first series is painted a certain % shade of the specified accent color, and the last series is painted a certain % tint of that color. The intermediate colors are linearly interpolated by shade and tint of the selected color. You can change the accent colors by selecting another document’s theme or creating the custom one.

Example

The example below demonstrates how to create a chart and apply one of the predefined styles to it using the ChartObject.Style property.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/winforms-spreadsheet-chart-api-e5222

StyleActions.vb

Dim worksheet As Worksheet = workbook.Worksheets("chartTask3")
workbook.Worksheets.ActiveWorksheet = worksheet

' Create a chart and specify its location.
Dim chart As Chart = worksheet.Charts.Add(ChartType.ColumnClustered, worksheet("B2:D4"))
chart.TopLeftCell = worksheet.Cells("H2")
chart.BottomRightCell = worksheet.Cells("N14")

' Set the chart style.
chart.Style = ChartStyle.Accent1Dark

StyleActions.cs

Worksheet worksheet = workbook.Worksheets["chartTask3"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// Create a chart and specify its location.
Chart chart = worksheet.Charts.Add(ChartType.ColumnClustered, worksheet["B2:D4"]);
chart.TopLeftCell = worksheet.Cells["H2"];
chart.BottomRightCell = worksheet.Cells["N14"];

// Set the chart style.
chart.Style = ChartStyle.Accent1Dark;

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Style 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.

C#

spreadsheet-document-api-chart-examples/CS/SpreadsheetDocServerChartAPISamples/CodeExamples/CreationAndDataActions.cs#L22

// Set the chart style.
chart.Style = ChartStyle.ColorGradient;

winforms-spreadsheet-chart-api-e5222/CS/SpreadsheetChartAPISamples/CodeExamples/CreationAndDataActions.cs#L22

// Set the chart style.
chart.Style = ChartStyle.ColorGradient;

wpf-spreadsheet-chart-api-t113198/CS/SpreadsheetWPFChartAPISamples/CodeExamples/StyleActions.cs#L22

// Set the chart style.
chart.Style = ChartStyle.Accent1Dark;

spreadsheet-how-to-add-a-chart-to-a-document-t467065/CS/T449201/DiagramCreationHelper.cs#L123

// Specify the chart style
chart.Style = ChartStyle.ColorGradient;

VB.NET

spreadsheet-document-api-chart-examples/VB/SpreadsheetDocServerChartAPISamples/CodeExamples/CreationAndDataActions.vb#L26

' Set the chart style.
chart.Style = ChartStyle.ColorGradient

winforms-spreadsheet-chart-api-e5222/VB/SpreadsheetChartAPISamples/CodeExamples/CreationAndDataActions.vb#L25

' Set the chart style.
chart.Style = ChartStyle.ColorGradient

wpf-spreadsheet-chart-api-t113198/VB/SpreadsheetWPFChartAPISamples/CodeExamples/StyleActions.vb#L26

' Set the chart style.
chart.Style = ChartStyle.Accent1Dark

spreadsheet-how-to-add-a-chart-to-a-document-t467065/VB/T449201/DiagramCreationHelper.vb#L123

' Specify the chart style
chart.Style = ChartStyle.ColorGradient