Help > 开发指南 > Excel > API > 示例 > 迷你图 >

如何：创建迷你图

工作表中的所有迷你图都按组进行组织。每个组可以包含一个或多个相同类型的迷你图，这些迷你图共享相同的格式设置和轴缩放选项。若要创建新的迷你图组，请使用 Worksheet.SparklineGroups 属性访问工作表的 SparklineGroupCollection 集合，然后调用 SparklineGroupCollection.Add 方法。传递以下参数。

• 一个 CellRange 对象，该对象指定迷你图组应位于的单元格区域。可以使用连续的一维区域，也可以通过在 Worksheet.Range 属性中的两个或多个单元格引用之间插入逗号来单独指定每个单元格。
• 一个 CellRange 对象，该对象指定迷你图组的数据源。若要一次添加多个迷你图，请在两个或多个引用之间插入逗号来引用 Worksheet.Range 属性中的多个范围，或使用 IRangeProvider.Union 方法将多个范围合并为一个复杂范围。请注意，单个迷你图的数据区域应为连续的一维单元格区域（其所有单元格都位于单行或单列中）。此外，非重复区域的数目必须等于位置范围中的单元格数（由 SparklineGroup.Position 属性定义）。如果指定的单元格区域不足以用于迷你图组，则会引发异常。
• 一个 SparklineGroupType 枚举值，该值指定迷你图组类型。下表列出了可用的迷你图组类型。

迷你图类型	说明	枚举值	描述	例
Line	线	SparklineGroupType.Line	用线连接迷你图数据点。
Column	列	SparklineGroupType.Column	创建一系列列，其长度与其表示的数据值成正比。
Win/Loss	赢/输	SparklineGroupType.Stacked	创建一系列正方形，每个正方形可以占据以下位置之一： 如果数据值为正数，则正方形显示在单元格的顶部 （win）; 如果该值为负数，则正方形显示在单元格的底部（损失）。

若要将新的迷你图添加到现有组，请使用 SparklineGroup.Sparklines 属性访问此组中包含的所有迷你图的集合，并调用 SparklineCollection.Add 方法。此方法允许您在指定行和列的交集处定义一个单元格，新迷你图应位于该行和列的交点，以及包含此迷你图的源数据的单元格区域。

Vb.Net

Dim worksheet As DevExpress.Spreadsheet.Worksheet = workbook.Worksheets("SparklineExamples") workbook.Worksheets.ActiveWorksheet = worksheet '创建一组线条迷你图。 Dim quarterlyGroup As DevExpress.Spreadsheet.SparklineGroup = worksheet.SparklineGroups.Add(worksheet("G4:G6"), worksheet("C4:F4,C5:F5,C6:F6"), DevExpress.Spreadsheet.SparklineGroupType.Line) '向现有组中再添加一条sparkline。 quarterlyGroup.Sparklines.Add(6, 6, worksheet("C7:F7")) '在合计单元格中显示一条列迷你图。 Dim totalGroup As DevExpress.Spreadsheet.SparklineGroup = worksheet.SparklineGroups.Add(worksheet("G8"), worksheet("C8:F8"), DevExpress.Spreadsheet.SparklineGroupType.Column)

C#

DevExpress.Spreadsheet.Worksheet worksheet = workbook.Worksheets["SparklineExamples"]; workbook.Worksheets.ActiveWorksheet = worksheet; // 创建一组线条迷你图。 DevExpress.Spreadsheet.SparklineGroup quarterlyGroup = worksheet.SparklineGroups.Add(worksheet["G4:G6"], worksheet["C4:F4,C5:F5,C6:F6"], DevExpress.Spreadsheet.SparklineGroupType.Line); // 向现有组中再添加一条sparkline。 quarterlyGroup.Sparklines.Add(6, 6, worksheet["C7:F7"]); // 在合计单元格中显示一条列迷你图。 DevExpress.Spreadsheet.SparklineGroup totalGroup = worksheet.SparklineGroups.Add(worksheet["G8"], worksheet["C8:F8"], DevExpress.Spreadsheet.SparklineGroupType.Column);