在 Aspose.Cells for .NET 中创建迷你图

Aspose.Cells 支持在工作表单元格内创建迷你图。迷你图是适合放置在单个单元格内的小型图表，可快速直观地展示数据趋势。Aspose.Cells 支持折线、柱形和盈亏迷你图，每种都可以自定义颜色、线宽、高/低点和标记。

简介

迷你图是单元格内的小型图表，当您希望在数据行或列旁边快速展示趋势而又不占用完整图表的空间时非常有用。Excel 支持三种迷你图：折线、柱形和盈亏。Aspose.Cells 通过 Aspose.Cells.Charts 命名空间中的 SparklineGroup 和 SparklineGroupCollection API 提供了同样的功能。在 Aspose.Cells 中，您添加的每个迷你图都是通过 worksheet.SparklineGroups.Add(...) 创建的，该方法返回一个 SparklineGroup 对象。然后，您可以使用该对象设置迷你图类型、数据区域、目标单元格以及视觉属性，如线条颜色、线宽、标记和高/低点指示器。本文将逐一介绍 Aspose.Cells 支持的三种迷你图类型——折线、柱形和盈亏——并演示如何添加它们、自定义颜色以及保存生成的工作簿。

折线迷你图

折线迷你图通过连续线条连接序列中的各个数据点，是展示随时间变化趋势的最自然选择。在 Aspose.Cells 中，通过将 SparklineType.Line 传递给 SparklineGroups.Add 方法即可创建折线迷你图。

创建一个新的 Workbook，并访问第一个工作表。
向源数据行（例如第 1 行的 A 到 E 列）填充您要可视化的值。
构建一个 CellArea，用于描述将绘制迷你图的目标单元格。
调用 worksheet.SparklineGroups.Add(SparklineType.Line, "A1:E1", false, dest)。第三个参数 false 告诉 Aspose.Cells 数据区域是水平方向（一行），而不是垂直方向（一列）。
（可选）自定义返回的 SparklineGroup。对于折线迷你图，您可以使用 group.Line.Color 设置线条颜色（该属性接受来自 Aspose.Cells.Drawing 的 CellsColor），调整线宽，并切换高/低点标记。
保存工作簿。以下示例创建一个工作簿，将值 5、-3、8、-2、6 写入单元格 A1 到 E1，并在 F1 单元格中添加一个折线迷你图来描绘这些值。同时，将线条颜色自定义为红色，并为高点和低点启用标记。

using System;
using Aspose.Cells;
using Aspose.Cells.Charts;
using Aspose.Cells.Drawing;
namespace SparklineDemo
{
    public class Program
    {
        public static void Main()
        {
            // 步骤 1：创建一个 Workbook 并获取第一个工作表
            Workbook workbook = new Workbook();
            Worksheet worksheet = workbook.Worksheets[0];
            Cells cells = worksheet.Cells;
            // 步骤 2：将示例值 5、-3、8、-2、6 写入单元格 A1:E1
            cells["A1"].PutValue(5);
            cells["B1"].PutValue(-3);
            cells["C1"].PutValue(8);
            cells["D1"].PutValue(-2);
            cells["E1"].PutValue(6);
            // 步骤 3：构建一个指向目标单元格 F1 的 CellArea
            CellArea dest = new CellArea();
            dest.StartColumn = 5;   // 列 F（从 0 开始索引）
            dest.EndColumn = 5;
            dest.StartRow = 0;      // 行 1（从 0 开始索引）
            dest.EndRow = 0;
            // 步骤 4：将 A1:E1 的折线迷你图添加到 F1
            // SparklineGroups.Add 返回新添加分组的索引
            int index = worksheet.SparklineGroups.Add(SparklineType.Line, "A1:E1", false, dest);
            SparklineGroup group = worksheet.SparklineGroups[index];
            // 步骤 5：创建一个红色的 CellsColor 并将其分配给迷你图线条颜色
            CellsColor red = workbook.CreateCellsColor();
            red.Color = System.Drawing.Color.Red;
            group.SeriesColor = red;
            // 步骤 6：启用高点标记和低点标记
            group.ShowHighPoint = true;
            group.ShowLowPoint = true;
            // 步骤 7：保存工作簿
            workbook.Save("output_line.xlsx");
        }
    }
}

柱形迷你图

柱形迷你图将每个数据点呈现为一个垂直条形。这使其非常适合数值大小具有实际意义的数据，例如月度销售数据或计数。在 Aspose.Cells 中，通过将 SparklineType.Column 传递给 SparklineGroups.Add 方法即可创建柱形迷你图。该过程与折线迷你图示例类似：

创建一个新的 Workbook，并访问第一个工作表。
构建一个 CellArea，用于描述目标单元格。
调用 worksheet.SparklineGroups.Add(SparklineType.Column, "A1:E1", false, dest)。
（可选）自定义生成的 SparklineGroup，例如通过设置 group.Type 来确认类型，或调整条形颜色。
将工作簿保存到单独的输出文件，以免覆盖折线迷你图示例。以下示例将值 5、-3、8、-2、6 写入 A1:E1，并在 F1 中呈现一个柱形迷你图。负值绘制为向下的条形，正值绘制为向上的条形，这样一眼就能看出正负贡献。

using System;
using Aspose.Cells;
using Aspose.Cells.Charts;
using Aspose.Cells.Drawing;
namespace SparklineDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 步骤 1：创建一个 Workbook 并获取第一个工作表
            Workbook workbook = new Workbook();
            Worksheet worksheet = workbook.Worksheets[0];
            // 步骤 2：将示例值写入 A1:E1
            int[] values = { 5, -3, 8, -2, 6 };
            for (int i = 0; i < values.Length; i++)
            {
                worksheet.Cells[0, i].PutValue(values[i]);
            }
            // 步骤 3：构建一个指向 F1（列索引 5，行索引 0）的 CellArea
            CellArea dest = new CellArea();
            dest.StartColumn = 5;
            dest.EndColumn = 5;
            dest.StartRow = 0;
            dest.EndRow = 0;
            // 步骤 4：在目标单元格添加一个 Column 迷你图
            int idx = worksheet.SparklineGroups.Add(
                SparklineType.Column, "A1:E1", false, dest);
            SparklineGroup group = worksheet.SparklineGroups[idx];
            // 步骤 5：通过读取 group.Type 确认迷你图类型
            Console.WriteLine("Sparkline Type added: " + group.Type);
            // 步骤 6：保存工作簿
            workbook.Save("output_column.xlsx");
            Console.WriteLine("Workbook saved as output_column.xlsx");
        }
    }
}

盈亏迷你图

盈亏迷你图是柱形迷你图的一种特殊变体，仅用于显示两种结果：正值绘制为"上升"条形（赢），零或负值绘制为"下降"条形（亏）。盈亏迷你图通常用于可视化一系列的胜负、及格/不及格结果，或随时间变化的任何二元结果。在 Aspose.Cells 中，通过将 SparklineType.Stacked 传递给 SparklineGroups.Add 方法即可创建盈亏迷你图。（尽管名称如此，SparklineType.Stacked 是用于请求盈亏呈现的枚举值。）

创建一个新的 Workbook，并访问第一个工作表。
填充源区域。由于盈亏迷你图将每个值视为赢或亏，因此值的大小无关紧要，只有正负才有意义。正值变为上升条形，非正值变为下降条形。
构建一个 CellArea，用于描述目标单元格。
调用 worksheet.SparklineGroups.Add(SparklineType.Stacked, "A1:E1", false, dest)。
（可选）自定义返回的 SparklineGroup，例如为赢条和亏条设置强调色。
使用不同的文件名保存工作簿，以便三个示例可以共存于磁盘上。

using System;
using Aspose.Cells;
using Aspose.Cells.Charts;
using Aspose.Cells.Drawing;
namespace SparklineDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 步骤 1：创建 Workbook 并获取第一个工作表
            Workbook workbook = new Workbook();
            Worksheet worksheet = workbook.Worksheets[0];
            worksheet.Name = "WinLoss";
            // 步骤 2：在第 1 行填充示例数据：A1=5, B1=-3, C1=8, D1=-2, E1=6
            worksheet.Cells["A1"].PutValue(5);
            worksheet.Cells["B1"].PutValue(-3);
            worksheet.Cells["C1"].PutValue(8);
            worksheet.Cells["D1"].PutValue(-2);
            worksheet.Cells["E1"].PutValue(6);
            // 步骤 3：构建一个指向 F1（第 5 列，第 0 行）的 CellArea
            CellArea dest = new CellArea();
            dest.StartColumn = 5;   // F
            dest.EndColumn = 5;
            dest.StartRow = 0;      // 第 1 行
            dest.EndRow = 0;
            // 步骤 4：添加一个 Win/Loss 迷你图（SparklineType.Stacked）
            int groupIndex = worksheet.SparklineGroups.Add(
                SparklineType.Stacked,
                "A1:E1",
                false,
                dest);
            SparklineGroup group = worksheet.SparklineGroups[groupIndex];
            // 步骤 5：自定义迷你图组
            // 启用高点标记和低点标记
            group.ShowHighPoint = true;
            group.ShowLowPoint = true;
            group.ShowNegativePoints = true;
            // 将高点颜色设置为绿色
            CellsColor highColor = workbook.CreateCellsColor();
            highColor.Color = System.Drawing.Color.Green;
            group.HighPointColor = highColor;
            // 将低点颜色设置为红色
            CellsColor lowColor = workbook.CreateCellsColor();
            lowColor.Color = System.Drawing.Color.Red;
            group.LowPointColor = lowColor;
            // 将负点颜色设置为橙色
            CellsColor negColor = workbook.CreateCellsColor();
            negColor.Color = System.Drawing.Color.Orange;
            group.NegativePointsColor = negColor;
            // 设置默认系列颜色（用于正值条）
            CellsColor seriesColor = workbook.CreateCellsColor();
            seriesColor.Color = System.Drawing.Color.SteelBlue;
            group.SeriesColor = seriesColor;
            // 步骤 6：保存 Workbook
            workbook.Save("output_winloss.xlsx");
            Console.WriteLine("Workbook saved successfully: output_winloss.xlsx");
        }
    }
}

组合使用三种迷你图类型

以下综合示例创建一个工作簿，将第 1 行填充为值 5、-3、8、-2、6，然后在单元格 F1、F2 和 F3 中添加三个迷你图组——每种类型一个——从而使生成的文件一次展示所有三种迷你图样式。

using System;
using Aspose.Cells;
using Aspose.Cells.Charts;
// 步骤 1：创建一个 Workbook 并获取第一个工作表
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
// 步骤 2：在第 1 行（A1:E1）填充示例数据
worksheet.Cells["A1"].PutValue(5);
worksheet.Cells["B1"].PutValue(-3);
worksheet.Cells["C1"].PutValue(8);
worksheet.Cells["D1"].PutValue(-2);
worksheet.Cells["E1"].PutValue(6);
// 步骤 3：在 F1 添加一个折线迷你图组
CellArea lineArea = new CellArea();
lineArea.StartColumn = 5;
lineArea.EndColumn = 5;
lineArea.StartRow = 0;
lineArea.EndRow = 0;
int lineIdx = worksheet.SparklineGroups.Add(SparklineType.Line, "A1:E1", false, lineArea);
SparklineGroup lineGroup = worksheet.SparklineGroups[lineIdx];
// 通过 CellsColor 自定义折线迷你图的颜色
CellsColor lineColor = workbook.CreateCellsColor();
lineColor.Color = System.Drawing.Color.Blue;
lineGroup.SeriesColor = lineColor;
// 步骤 4：在 F2 添加一个柱形迷你图组
CellArea columnArea = new CellArea();
columnArea.StartColumn = 5;
columnArea.EndColumn = 5;
columnArea.StartRow = 1;
columnArea.EndRow = 1;
int columnIdx = worksheet.SparklineGroups.Add(SparklineType.Column, "A1:E1", false, columnArea);
SparklineGroup columnGroup = worksheet.SparklineGroups[columnIdx];
// 自定义柱形迷你图系列的颜色
CellsColor columnColor = workbook.CreateCellsColor();
columnColor.Color = System.Drawing.Color.Green;
columnGroup.SeriesColor = columnColor;
// 步骤 5：在 F3 添加一个盈亏（堆叠）迷你图组
CellArea stackedArea = new CellArea();
stackedArea.StartColumn = 5;
stackedArea.EndColumn = 5;
stackedArea.StartRow = 2;
stackedArea.EndRow = 2;
int stackedIdx = worksheet.SparklineGroups.Add(SparklineType.Stacked, "A1:E1", false, stackedArea);
SparklineGroup stackedGroup = worksheet.SparklineGroups[stackedIdx];
// 自定义盈亏迷你图系列的颜色
CellsColor stackedColor = workbook.CreateCellsColor();
stackedColor.Color = System.Drawing.Color.DarkOrange;
stackedGroup.SeriesColor = stackedColor;
// 步骤 6：保存工作簿
workbook.Save("output_all.xlsx");

自定义迷你图外观

创建 SparklineGroup 并将其添加到 worksheet.SparklineGroups 后，您可以在保存工作簿之前读取或修改其多个视觉属性。最常用的自定义属性包括：

group.Type — SparklineType（Line、Column 或 Stacked）。该属性在添加组时设置，但您可以读回它以进行确认。
group.Line.Color — 线条颜色，以通过 workbook.CreateCellsColor() 创建的 CellsColor 表示。这是用于折线迷你图描边颜色的属性。
group.Line.Weight — 以磅为单位的线宽。值越大，线条越粗。
高/低点标记 — 用于在最高和最低数据点上显示小标记的标志，有助于突出极值。
首/末/负点标记 — 用于在第一个、最后一个和负值数据点上切换标记的标志。要更改颜色，请始终创建一个 CellsColor 实例并将其分配给相关属性。不要将 System.Drawing.Color 直接分配给迷你图的颜色属性——这些属性需要来自 Aspose.Cells.Drawing 的 CellsColor 类型。SparklineGroups.Add 方法本身会返回一个完全类型的 SparklineGroup 对象，因此您可以在返回值上链式调用属性赋值，或将其存储在局部变量中并在保存之前进行自定义。

智能导入与放置数据，配合智能标记管理Excel宏启用的工作簿的VBA代码。