使用 Apache POI 在 Excel 表中绘制形状的 Java 程序

Apache POI 是一款 Java API，用于操作 Microsoft Office 格式的文件，其中包括 Word、Excel 和 PowerPoint 等。本篇文章将介绍如何使用 Apache POI 在 Excel 表中绘制形状。

程序演示

首先，我们先看一下最终实现的效果：

如图所示，该 Excel 表包括一个椭圆形状和一个文本框，并且它们都被放置在固定的位置上。

使用 Apache POI 绘制形状

在 Apache POI 中绘制形状需要使用 XSSFDrawing 类。XSSFDrawing 类是一个顶层保持对象 (Top Level Container)，它拥有所有的图形元素，并将它们嵌入到 Excel 工作簿中。要使用它创建形状，我们需要完成以下步骤：

1. 获取工作簿中的 XSSFDrawing 对象：

XSSFWorkbook workbook = new XSSFWorkbook();
XSSFSheet sheet = workbook.createSheet();
XSSFDrawing drawing = sheet.createDrawingPatriarch();

2. 使用 XSSFDrawing 对象和形状定义来创建形状：

// 创建文本框形状
XSSFClientAnchor anchor = drawing.createAnchor(0, 0, 0, 0, 2, 2, 4, 4);
XSSFTextBox textBox = drawing.createTextbox(anchor);
textBox.setString(new XSSFRichTextString("This is a TextBox!"));

// 创建椭圆形状
XSSFClientAnchor anchor2 = drawing.createAnchor(0, 0, 0, 0, 6, 2, 8, 4);
XSSFSimpleShape shape = drawing.createSimpleShape(anchor2);
shape.setShapeType(ShapeTypes.ELLIPSE);

该代码创建了两个形状：一个文本框和一个椭圆形。可以看到，每个形状都被创建在一个 XSSFClientAnchor 对象内，该对象定义了形状的位置和大小范围。

完整代码

下面是一个完整的 Java 程序，它在 Excel 表中绘制了一个文本框形状和一个椭圆形状：

import java.io.FileOutputStream;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.*;
import org.openxmlformats.schemas.drawingml.x2006.main.*;

public class DrawShapeInExcel {

    public static void main(String[] args) throws Exception {
        XSSFWorkbook workbook = new XSSFWorkbook();
        XSSFSheet sheet = workbook.createSheet();
        XSSFDrawing drawing = sheet.createDrawingPatriarch();

        // 创建文本框形状
        XSSFClientAnchor anchor = drawing.createAnchor(0, 0, 0, 0, 2, 2, 4, 4);
        XSSFTextBox textBox = drawing.createTextbox(anchor);
        textBox.setString(new XSSFRichTextString("This is a TextBox!"));

        // 创建椭圆形状
        XSSFClientAnchor anchor2 = drawing.createAnchor(0, 0, 0, 0, 6, 2, 8, 4);
        XSSFSimpleShape shape = drawing.createSimpleShape(anchor2);
        shape.setShapeType(ShapeTypes.ELLIPSE);

        FileOutputStream fileOut = new FileOutputStream("draw-shape-in-excel.xlsx");
        workbook.write(fileOut);
        fileOut.close();
        System.out.println("Excel 文件已生成！");
    }
}

总结

在 Apache POI 中创建和操作 Excel 文件的能力使得开发者能够更加灵活和高效地生成和管理 Excel 文件。使用 XSSFDrawing 类可以轻松地在 Excel 表中添加形状和其他对象，以达到更好的数据可视化效果。