Back to Devexpress

SparklineGroupCollection.Add(IList<Sparkline>, SparklineGroupType) Method

officefileapi-devexpress-dot-spreadsheet-dot-sparklinegroupcollection-dot-add-x28-system-dot-collections-dot-generic-dot-ilist-devexpress-dot-spreadsheet-dot-sparkline-devexpress-dot-spreadsheet-dot-sparklinegrouptype-x29.md

latest5.8 KB
Original Source

SparklineGroupCollection.Add(IList<Sparkline>, SparklineGroupType) Method

Creates a new sparkline group from the existing sparklines and returns the SparklineGroup object.

Namespace : DevExpress.Spreadsheet

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

NuGet Package : DevExpress.Spreadsheet.Core

Declaration

csharp
SparklineGroup Add(
    IList<Sparkline> sparklines,
    SparklineGroupType type
)
vb
Function Add(
    sparklines As IList(Of Sparkline),
    type As SparklineGroupType
) As SparklineGroup

Parameters

NameTypeDescription
sparklinesIList<Sparkline>

A list of the Sparkline objects to form a group.

| | type | SparklineGroupType |

A SparklineGroupType enumeration member specifying the type of the group to be created.

|

Returns

TypeDescription
SparklineGroup

A SparklineGroup object that is the newly created group of sparklines.

|

Remarks

Use this method to rearrange the existing Sparkline objects in a worksheet to form a new group with its own settings.

View Example

csharp
Worksheet worksheet = workbook.Worksheets["SparklineExamples"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// Create a group of line sparklines.
SparklineGroup lineGroup = worksheet.SparklineGroups.Add(worksheet["G4:G7"], worksheet["C4:F4,C5:F5,C6:F6, C7:F7"], SparklineGroupType.Line);

// Rearrange sparklines by grouping the second and fourth sparklines together and changing the group type to "Column".
Sparkline sparklineG5 = lineGroup.Sparklines[1];
Sparkline sparklineG7 = lineGroup.Sparklines[3];
SparklineGroup columnGroup = worksheet.SparklineGroups.Add(new List<Sparkline> { sparklineG5, sparklineG7 }, SparklineGroupType.Column);
vb
Dim worksheet As Worksheet = workbook.Worksheets("SparklineExamples")
workbook.Worksheets.ActiveWorksheet = worksheet

' Create a group of line sparklines.
Dim lineGroup As SparklineGroup = worksheet.SparklineGroups.Add(worksheet("G4:G7"), worksheet("C4:F4,C5:F5,C6:F6, C7:F7"), SparklineGroupType.Line)

' Rearrange sparklines by grouping the second and fourth sparklines together and changing the group type to "Column".
Dim sparklineG5 As Sparkline = lineGroup.Sparklines(1)
Dim sparklineG7 As Sparkline = lineGroup.Sparklines(3)
Dim columnGroup As SparklineGroup = worksheet.SparklineGroups.Add(New List(Of Sparkline)(New Sparkline() {sparklineG5, sparklineG7}), SparklineGroupType.Column)

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Add(IList<Sparkline>, SparklineGroupType) 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.

spreadsheet-document-api-chart-examples/CS/SpreadsheetDocServerChartAPISamples/CodeExamples/SparklineActions.cs#L42

csharp
Sparkline sparklineG7 = lineGroup.Sparklines[3];
SparklineGroup columnGroup = worksheet.SparklineGroups.Add(new List<Sparkline> { sparklineG5, sparklineG7 }, SparklineGroupType.Column);
#endregion #RearrangeSparklines

spreadsheet-document-api-chart-examples/VB/SpreadsheetDocServerChartAPISamples/CodeExamples/SparklineActions.vb#L41

vb
Dim sparklineG7 As Sparkline = lineGroup.Sparklines(3)
            Dim columnGroup As SparklineGroup = worksheet.SparklineGroups.Add(New List(Of Sparkline)(New Sparkline() {sparklineG5, sparklineG7}), SparklineGroupType.Column)
#End Region ' #RearrangeSparklines

See Also

How to: Group and Ungroup Sparklines

SparklineGroupCollection Interface

SparklineGroupCollection Members

DevExpress.Spreadsheet Namespace