Java中使用POI在Excel单元格中画斜线

一起养成写作习惯！这是我参与「掘金日新计划 · 4 月更文挑战」的第1天。

在将报表导出Excel文件的时候，经常会有斜线表头的使用场景。如果你有以下困惑：如何在Excel中画设置斜线表头？如何画多条斜线表头？本文可以给你一点解惑思路。

在导出Excel文件的时候，如果想要实现斜线表头的效果，其实就是在Excel单元格中画斜线。Java中通常使用POI库对Excel进行编辑。Excel不同的版本对应的格式也不同，主要有xls和xlsx两种格式，两种格式对应的POI接口不同，使用方法也不同。

1、XLS格式

XLS格式的Excel操作对象是HSSF开头的，例如HSSFWorkbook、HSSFSheet、HSSFRow等等；

1.1、初始化HSSFWorkbook对象

初始化HSSFWorkbook对象，创建两行两列单元格，分别设置行高和列宽以及单元格的边框。

/**
 * @Author 通靈鹿小六
 * @Description 模拟测试使用的HSSFWorkbook对象
 * @return org.apache.poi.hssf.usermodel.HSSFWorkbook HSSFWorkbook对象
 **/
private HSSFWorkbook getTestHSSFWorkbook() {
	HSSFWorkbook wb = new HSSFWorkbook();
	HSSFSheet sheet = wb.createSheet("line");
	HSSFRow row0 = sheet.createRow(0);
	row0.setHeightInPoints(90);
	HSSFRow row1 = sheet.createRow(1);
	row1.setHeightInPoints(70);

	HSSFCellStyle cellStyle = getCellFormat(wb);

	sheet.setColumnWidth(0, 90 * 90);
	sheet.setColumnWidth(1, 60 * 90);
	HSSFCell cell0_0 = row0.createCell(0);
	HSSFCell cell0_1 = row0.createCell(1);
	HSSFCell cell1_0 = row1.createCell(0);
	HSSFCell cell1_1 = row1.createCell(1);
	cell0_0.setCellStyle(cellStyle);
	cell0_1.setCellStyle(cellStyle);
	cell1_0.setCellStyle(cellStyle);
	cell1_1.setCellStyle(cellStyle);

	return wb;
}

private HSSFCellStyle getCellFormat(HSSFWorkbook wb) {
	HSSFCellStyle cellStyle = wb.createCellStyle();
	if (cellStyle.getBorderBottom() != BorderStyle.THIN) {
		cellStyle.setBorderBottom(BorderStyle.THIN);
	}
	if (cellStyle.getBorderLeft() != BorderStyle.THIN) {
		cellStyle.setBorderLeft(BorderStyle.THIN);
	}
	if (cellStyle.getBorderTop() != BorderStyle.THIN) {
		cellStyle.setBorderTop(BorderStyle.THIN);
	}
	if (cellStyle.getBorderRight() != BorderStyle.THIN) {
		cellStyle.setBorderRight(BorderStyle.THIN);
	}
	cellStyle.setBottomBorderColor((short) 0);
	cellStyle.setLeftBorderColor((short) 0);
	cellStyle.setRightBorderColor((short) 0);
	cellStyle.setTopBorderColor((short) 0);
	return cellStyle;
}

1.2、在Cell中画斜线

/**
 * @Author 通靈鹿小六
 * @Description 在XLS文件中画斜线
 * @param sheet HSSFSheet格式对象
 * @param rowIndex 斜线表头单元格行索引
 * @param colIndex 斜线表头单元格列索引
 * @param slpList 斜线表头线集合
 **/
private static void drawLineXls(HSSFSheet sheet, int rowIndex, int colIndex, ArrayList<SlashLinePosition> slpList) {
	HSSFPatriarch hssfPatriarch = sheet.createDrawingPatriarch();
	HSSFClientAnchor hssfClientAnchor = new HSSFClientAnchor(0, 0, ANCHOR_X, ANCHOR_Y, (short) colIndex, rowIndex, (short) colIndex, rowIndex);
	HSSFShapeGroup hssfShapes = hssfPatriarch.createGroup(hssfClientAnchor);
	float verticalPointsPerPixel = hssfClientAnchor.getAnchorHeightInPoints(sheet);
	EscherGraphics eg = new EscherGraphics(hssfShapes, sheet.getWorkbook(), Color.black, verticalPointsPerPixel);
	EscherGraphics2d eg2D = new EscherGraphics2d(eg);

	for (SlashLinePosition slp : slpList) {
		eg2D.drawLine(slp.getStartX(), slp.getStartY(), slp.getEndX(), slp.getEndY());
	}
}

其中ANCHOR_X和ANCHOR_Y是固定值，定义如下：

/**
 * 画线定位锚的X坐标
 **/
public static final int ANCHOR_X = 1023;

/**
 * 画线定位锚的Y坐标
 **/
public static final int ANCHOR_Y = 255;

SlashLinePosition类主要是定义斜线起始点的坐标和结束点的坐标。类定义如下所示：

import lombok.Getter;
import lombok.Setter;

/**
 * @ClassName: SlashLinePosition
 * @Description: 斜线位置坐标
 * @Author: 通靈鹿小六
 * @CreateDate: 2021-01-26 16:56 
 **/
@Getter
@Setter
public class SlashLinePosition {

    public SlashLinePosition(int startX, int startY, int endX, int endY) {
        this.startX = startX;
        this.startY = startY;
        this.endX = endX;
        this.endY = endY;
    }

    /**
     * 斜线起始点X轴坐标
     **/
    private int startX;

    /**
     * 斜线起始点Y轴坐标
     **/
    private int startY;

    /**
     * 斜线结束点X轴坐标
     **/
    private int endX;

    /**
     * 斜线结束点Y轴坐标
     **/
    private int endY;
}

HSSFClientAnchor用于创建一个新的端锚，并设置锚的左下和右下坐标,用于图片插入，画线等操作。

HSSFClientAnchor(int dx1, int dy1, int dx2, int dy2, short col1, int row1, short col2, int row2) dx1, dy1 斜线起始点所在单元格中的x,y坐标； dx2, dy2 斜线结束点所在单元格中的x,y坐标； col1, row1 指定起始的单元格，下标从0开始； col2, row2 指定结束的单元格 ，下标从0开始；

个人理解： HSSFClientAnchor相当于定义了一个画布。 画布的起始坐标为col1，row1所在单元格的dx1和dy1的位置，画布的结束坐标为col2，row2所在单元格的dx2和dy2的位置。

而在画布上面画线，则需要使用方法eg2D.drawLine(slp.getStartX(), slp.getStartY(), slp.getEndX(), slp.getEndY());

例如：我们想在Excel的A1单元格中画三条线。如下图所示：

第一步：分析在A1单元格中画线，那么起始点单元格和终止点单元格都为A1。所以定义如下： HSSFClientAnchor hssfClientAnchor = new HSSFClientAnchor(0, 0, 1023, 255, (short) 0, 0, (short) 0, 0);

第二步：画红线。红线起始坐标为画布的左上角，终止坐标为画布的右下角。 eg2D.drawLine(0, 0, 1023, 255);

第三步：画绿线。绿线起始坐标为画布的左上角，终止坐标的X轴为画布宽度的一半，Y轴为画布的高度。 eg2D.drawLine(0, 0, 1023/2, 255);

第四步：画黄线。黄线起始坐标为画布的左上角，终止坐标的X轴为画布宽度，Y轴为画布高度的一半。 eg2D.drawLine(0, 0, 1023, 255/2);

最终能够画出如上图所示的斜线。

在一个单元格中根据斜线类型以及斜线数量，计算坐标位置。

注意：如果画斜线的时候，跨单元格的情况，需要自行计算起止坐标位置。示例中只是计算在同一个单元格，以不同的位置作为起点，计算的坐标值；

1.3、斜线效果

生成一条斜线，效果如下图所示：

生成两条斜线，效果如下图所示：

2、XLSX格式

与XLS格式不同的是，XLSX的Excel操作对象是XSSF开头的，例如XSSFWorkbook、XSSFSheet、XSSFRow等等；

2.1、初始化XSSFWorkbook对象

初始化XSSFWorkbook对象，创建两行两列单元格，分别设置行高和列宽以及单元格的边框。

/**
 * @Author 通靈鹿小六
 * @Description 模拟测试使用的XSSFWorkbook对象
 * @return org.apache.poi.xssf.usermodel.XSSFWorkbook
 **/
private XSSFWorkbook getTestXSSFWorkbook() {
	XSSFWorkbook wb = new XSSFWorkbook();
	XSSFSheet sheet = wb.createSheet("line");
	XSSFRow row0 = sheet.createRow(0);
	row0.setHeightInPoints(100);
	XSSFRow row1 = sheet.createRow(1);
	row1.setHeightInPoints(70);

	XSSFCellStyle cellStyle = getCellFormat(wb);

	sheet.setColumnWidth(0, 80 * 90);
	sheet.setColumnWidth(1, 60 * 90);
	XSSFCell cell0_0 = row0.createCell(0);
	XSSFCell cell0_1 = row0.createCell(1);
	XSSFCell cell1_0 = row1.createCell(0);
	XSSFCell cell1_1 = row1.createCell(1);
	cell0_0.setCellStyle(cellStyle);
	cell0_1.setCellStyle(cellStyle);
	cell1_0.setCellStyle(cellStyle);
	cell1_1.setCellStyle(cellStyle);

	return wb;
}

private XSSFCellStyle getCellFormat(XSSFWorkbook wb) {
	XSSFCellStyle cellStyle = wb.createCellStyle();
	if (cellStyle.getBorderBottom() != BorderStyle.THIN) {
		cellStyle.setBorderBottom(BorderStyle.THIN);
	}
	if (cellStyle.getBorderLeft() != BorderStyle.THIN) {
		cellStyle.setBorderLeft(BorderStyle.THIN);
	}
	if (cellStyle.getBorderTop() != BorderStyle.THIN) {
		cellStyle.setBorderTop(BorderStyle.THIN);
	}
	if (cellStyle.getBorderRight() != BorderStyle.THIN) {
		cellStyle.setBorderRight(BorderStyle.THIN);
	}
	cellStyle.setBottomBorderColor((short) 0);
	cellStyle.setLeftBorderColor((short) 0);
	cellStyle.setRightBorderColor((short) 0);
	cellStyle.setTopBorderColor((short) 0);

	cellStyle.setVerticalAlignment(VerticalAlignment.CENTER);

	XSSFFont xssfFont = wb.createFont();
	xssfFont.setFontName("Arial");
	cellStyle.setFont(xssfFont);

	return cellStyle;
}

2.2、在Cell中画斜线

注意：在XLSX格式的单元格中画线的时候，是不支持从下往上画的。换个说法，斜线的终止点坐标X必须大于等于起始点坐标X，终止点坐标Y必须大于等于起始点坐标Y。

如下图所示两种情况，是需要特殊处理的。：

/**
 * @Author 通靈鹿小六
 * @Description 在XLSX文件中画斜线
 * @param sheet XSSFSheet格式对象
 * @param rowIndex 斜线表头单元格行索引
 * @param colIndex 斜线表头单元格列索引
 * @param slashType 斜线类型
 * @param slpList 斜线表头线集合
 **/
private static void drawLineXlsx(XSSFSheet sheet, int rowIndex, int colIndex, String slashType, ArrayList<SlashLinePosition> slpList) {
	XSSFDrawing xssfDrawing = sheet.createDrawingPatriarch();

	for (SlashLinePosition slp : slpList) {
		XSSFClientAnchor xssfClientAnchor = new XSSFClientAnchor(
				slp.getStartX(), slp.getStartY(), slp.getEndX(), slp.getEndY(),
				colIndex, rowIndex, colIndex, rowIndex);
		XSSFSimpleShape shape = xssfDrawing.createSimpleShape(xssfClientAnchor);

		if (slashType == "LEFT_TOP" || slashType == "RIGHT_BOTTOM") {
			//斜线类型为左上，右下的时候，使用斜线
			shape.setShapeType(ShapeTypes.LINE);
		} else {
			//斜线类型为左下，右上的时候，使用反斜线
			shape.setShapeType(ShapeTypes.LINE_INV);
		}
		// 设置线宽
		shape.setLineWidth(0.5);
		// 设置线的风格
		shape.setLineStyle(0);
		// 设置线的颜色
		shape.setLineStyleColor(0, 0, 0);
	}
}

如果我们想画如下一条斜线：

上面说了，不能从下往上画线。所以要使用反斜线。而在使用反斜线的同时，线条的坐标也要发生变化。

最终定义如图2所示的坐标，同时设置线条为反斜线，最终生成的单元格效果和图1一样。

2.3、计算线的坐标

结合第二点中介绍的内容，当斜线类型为LEFT_BOTTOM和RIGHT_TOP的时候，计算线的起止坐标也会有不一样。

代码中，定义width和heigth的时候，分别乘以了不同的系数。系数是我测试出来的，但是没有弄清楚为何这样子，如果有明白的人可以告诉我一下。

int width = xssfSheet.getColumnWidth(colIndex) * 300; int height = xssfSheet.getRow(rowIndex).getHeight() * 700;

2.4、斜线效果

最终生成的效果如下图所示：

如果本文对您有了启发作用，请动动小手，麻烦点个赞~~