使用NPOI为Excel柱状图设置自定义列颜色

概述

在Excel报表开发中，柱状图是常用的数据可视化方式之一。NPOI作为.NET平台下操作Office文档的强大库，提供了创建和修改Excel图表的功能。本文将详细介绍如何使用NPOI为Excel柱状图的每一列设置不同的自定义颜色。

实现原理

NPOI通过操作OpenXML格式的底层结构来实现对Excel图表的控制。要为柱状图的每一列设置不同颜色，我们需要：

1. 创建基本的柱状图
2. 获取图表的数据点(Data Point)集合
3. 为每个数据点单独设置填充颜色

具体实现步骤

1. 创建基础柱状图

首先需要创建基本的柱状图结构，包括：

• 图表数据源
• 坐标轴
• 图例
• 基本样式设置

// 创建图表
XSSFChart chart = (XSSFChart)drawing.CreateChart(anchor);

// 创建柱状图数据
IColumnChartData<string, double> columnChartData = chart.ChartDataFactory.CreateColumnChartData<string, double>();

// 设置图例
IChartLegend legend = chart.GetOrCreateLegend();
legend.Position = LegendPosition.Bottom;

// 设置坐标轴
IChartAxis bottomAxis = chart.ChartAxisFactory.CreateCategoryAxis(AxisPosition.Bottom);
bottomAxis.MajorTickMark = AxisTickMark.None;
IValueAxis leftAxis = chart.ChartAxisFactory.CreateValueAxis(AxisPosition.Left);
leftAxis.Crosses = AxisCrosses.AutoZero;
leftAxis.SetCrossBetween(AxisCrossBetween.Between);

// 添加数据系列
IChartDataSource<string> categoryAxis = DataSources.FromStringCellRange(sheet, new CellRangeAddress(startDataRow, endDataRow, 0, 0));
IChartDataSource<double> valueAxis = DataSources.FromNumericCellRange(sheet, new CellRangeAddress(startDataRow, endDataRow, columnIndex, columnIndex));
var serie = columnChartData.AddSeries(categoryAxis, valueAxis);
serie.SetTitle("Categories of Risk Associated");

// 绘制图表
chart.Plot(columnChartData, bottomAxis, leftAxis);

2. 设置自定义列颜色

在基础图表创建完成后，我们可以为每个数据点设置不同的颜色：

// 定义颜色数组(RGB格式)
byte[][] colors = new byte[][] {
    new byte[] {127, 255, 127},  // 浅绿色
    new byte[] {200, 200, 200},  // 灰色
    new byte[] {255, 255, 127},  // 浅黄色
    new byte[] {255, 127, 127},  // 浅红色
    new byte[] {255, 0, 0},      // 红色
    new byte[] {0, 255, 0},      // 绿色
    new byte[] {0, 0, 255},      // 蓝色
    new byte[] {80, 80, 80},     // 深灰色
    new byte[] {90, 80, 80},     // 红灰色
    new byte[] {100, 80, 80}     // 深红灰色
};

// 获取数据点数量
int pointCount = serie.GetCategoryAxisData().PointCount;

// 获取图表绘图区域
var plotArea = chart.GetCTChart().plotArea;

// 初始化数据点集合
plotArea.barChart[0].ser[0].dPt = new System.Collections.Generic.List<NPOI.OpenXmlFormats.Dml.Chart.CT_DPt>();

// 为每个数据点设置颜色
for (int i = 0; i < pointCount; i++)
{
    plotArea.barChart[0].ser[0].dPt.Add(new NPOI.OpenXmlFormats.Dml.Chart.CT_DPt());
    plotArea.barChart[0].ser[0].dPt[i].idx = new NPOI.OpenXmlFormats.Dml.Chart.CT_UnsignedInt() { val = (uint)i};
    plotArea.barChart[0].ser[0].dPt[i].spPr = new NPOI.OpenXmlFormats.Dml.Chart.CT_ShapeProperties();
    plotArea.barChart[0].ser[0].dPt[i].spPr.AddNewSolidFill().AddNewSrgbClr().val = colors[i];
}

3. 使用主题颜色(可选)

如果需要使用Excel的主题颜色而非自定义RGB值，可以简单设置：

chart.GetCTChart().plotArea.barChart[0].varyColors = new NPOI.OpenXmlFormats.Dml.Chart.CT_Boolean() { val = 1 };

注意事项

1. 颜色数组的大小应该至少等于数据点的数量，否则会抛出索引越界异常
2. RGB颜色值的范围是0-255，使用byte类型存储
3. 如果需要更多颜色变化，可以扩展颜色数组
4. 此方法同样适用于其他类型的图表，如条形图、饼图等

总结

通过NPOI提供的底层OpenXML操作接口，我们可以灵活地控制Excel图表的各种样式属性，包括为柱状图的每一列设置不同的颜色。这种方法不仅适用于简单的报表需求，也可以满足复杂的数据可视化场景。掌握这些技巧后，开发者可以创建出更加专业和美观的Excel报表。