SpreadJS 迷你图

除了MS Excel支持的标准迷你图之外，SpreadJS还支持级联迷你图。GcExcel Java支持将包含级联迷你图的SpreadJS文件导出为JSON导入导出、HTML、图像和PDF格式。本主题讨论这些扩展迷你图以及如何在GcExcel Java中创建它们。

级联迷你图

级联迷你图通常用于分析一段时间内的价值，如年销售额、总利润、净税收等。它广泛用于金融、销售、法律和建筑行业，仅举几个例子。例如，您可以使用级联迷你图来比较销售人员的支出和收入。

GcExcel Java提供了用于创建级联迷你图的 CASCADESPARKLINE 公式。

语法

= CASCADESPARKLINE(pointsRange, pointIndex, labelsRange, minimum, maximum, colorPositive, colorNegative, vertical)

参数

参数名称	描述
pointsRange（必须）	表示包含值的单元格范围的引用，如“B2:B8”。
pointIndex（必须）	表示点索引的数字或引用。点索引是 >= 1，例如 1 或 “D2”。
LabelsRange（可选）	表示包含标签的单元格范围的引用，如“A2:A8”。默认值为无标签。
Minimum（可选）	表示显示区域最小值的数字或参考。默认值是总和（点值之和）的最小值，如-2000。您设置的最小值必须小于默认最小值；否则，使用默认最小值。
maximum（可选）	表示显示区域最大值的数字或参考。默认值是总和（点值的总和）的最大值，如6000。您设置的最大值必须大于默认最大值；否则，将使用默认最大值。
colorPositive（可选）	表示第一个或最后一个正迷你图框颜色的字符串（该点的值为正）。默认值为“#8CBF64”。如果第一个或最后一个框表示正值，则框的颜色将设置为 colorPositive 。中间正片框设置为比彩色正片更浅的颜色。
colorNegative（可选）	表示第一个或最后一个负迷你图框颜色的字符串（该点的值为负）。默认值为“#D6604D”。如果第一个或最后一个框表示负值，则框的颜色将设置为colorNegative。中间负片框设置为比彩色负片更浅的颜色。
vertical（可选）	表示框的方向是垂直还是水平的布尔值。默认值为FALSE。对于一组公式，必须将垂直设置为true或false，因为所有公式都表示整个迷你图。
itemTypeRange（可选）	表示数据范围的所有项类型的数组或引用。这些值应为{-、“+”、“=”}或“A1:A7”，它们引用了{“+”、”-“、“=”的值，其中“+”表示正变化，“-”表示负变化，“=”表示总列数。
colorTotal（可选）	一个字符串，当itemTypeRange不存在时表示最后一个小迷你图框的颜色，或者当ItemType Range存在时表示结果小迷你图的框的颜色。

请参考以下示例代码，使用公式添加级联迷你图。

// Add a cascade sparkline with horizontal bars.
for (int i = 1; i < 8; i++) {
    worksheet.getRange(i, 2).setFormula("=CASCADESPARKLINE(B2:B8, ROW() - 1, A2:A8, , , \"#8CBF64\", \"#D6604D\", FALSE)");
}

注意：MS Excel不支持级联迷你图公式，因此在导出Excel后会出现"#NAME?"。但是，在将文件导入回GcExcel Java时，公式将正确显示。