ChartCollection.Add(ChartType, Range) Method

Creates a chart of the specified type with data from the specified range and adds the chart to the collection.

Namespace: DevExpress.Spreadsheet.Charts

Assembly: DevExpress.Spreadsheet.v18.2.Core.dll

Declaration

C#

Chart Add(
    ChartType chartType,
    Range range
)

VB.NET

Function Add(
    chartType As ChartType,
    range As Range
) As Chart

Parameters

Name	Type	Description
chartType	ChartType	A ChartType enumeration member specifying the chart type.
range	Range	A Range containing chart data.

Returns

Type	Description
Chart	A Chart object that is the chart embedded in a worksheet.

Remarks

The example below demonstrates how to create a 3-D pie chart using the ChartCollection.Add method overload that enables you to specify a Range containing chart data.

Note

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

CreationAndDataActions.vb

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

' Create a pie chart and specify its location.
Dim chart As Chart = worksheet.Charts.Add(ChartType.Pie3D, worksheet("B2:C7"))
chart.TopLeftCell = worksheet.Cells("E2")
chart.BottomRightCell = worksheet.Cells("K15")

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

CreationAndDataActions.cs

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

// Create a pie chart and specify its location.
Chart chart = worksheet.Charts.Add(ChartType.Pie3D, worksheet["B2:C7"]);
chart.TopLeftCell = worksheet.Cells["E2"];
chart.BottomRightCell = worksheet.Cells["K15"];

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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Add(ChartType, Range) method.

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/AxesActions.cs#L17

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

winforms-spreadsheet-chart-api-e5222/CS/SpreadsheetChartAPISamples/CodeExamples/AxesActions.cs#L17

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

wpf-spreadsheet-chart-api-t113198/CS/SpreadsheetWPFChartAPISamples/CodeExamples/SeriesActions.cs#L17

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

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

Chart chart = worksheet.Charts.Add(ChartType.ColumnClustered, worksheet["B2:D8"]);
chart.TopLeftCell = worksheet.Cells["F2"];

VB.NET

spreadsheet-document-api-chart-examples/VB/SpreadsheetDocServerChartAPISamples/CodeExamples/Charts1.vb#L21

' Create a Pie of Pie chart and specify its position.
Dim chart As Chart = worksheet.Charts.Add(ChartType.PieOfPie, worksheet("B2:C11"))
chart.TopLeftCell = worksheet.Cells("E2")

winforms-spreadsheet-chart-api-e5222/VB/SpreadsheetChartAPISamples/CodeExamples/AxesActions.vb#L20

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

wpf-spreadsheet-chart-api-t113198/VB/SpreadsheetWPFChartAPISamples/CodeExamples/SeriesActions.vb#L21

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

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

Dim chart As Chart = worksheet.Charts.Add(ChartType.ColumnClustered, worksheet("B2:D8"))
chart.TopLeftCell = worksheet.Cells("F2")