Java 添加、修改、读取、复制、删除Excel批注

批注，是作者或审阅者给文档添加的注释或注解。通过查看批注，可以更加详细地了解某些文字的背景。除了直接添加文本信息外，还可为文本信息填充背景图片使其更具丰富性和美观性。本文将通过使用Java程序来演示如何在Excel文档中添加、修改、读取、复制和删除批注。

使用工具: Free Spire.XLS for Java （免费版）

Jar文件获取及导入：

方法1：通过官方网站下载获取jar包。解压后将lib文件夹下的Spire.Xls.jar文件导入Java程序。（如下图）

方法2：通过maven仓库安装导入。具体安装详解参见此网页。

【示例1】添加批注

import com.spire.xls.*;
import java.awt.*;
public class AddComments {
    public static void main(String[] args) {

        //加载Excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("D:\\Desktop\\Sample.xlsx");

        //获取工作表
        Worksheet sheet = wb.getWorksheets().get(0);

        //创建字体
        ExcelFont font = wb.createFont();
        font.setFontName("Arial");
        font.setSize(11);
        font.setKnownColor(ExcelColors.Orange);
        ExcelFont fontBlue = wb.createFont();
        fontBlue.setKnownColor(ExcelColors.LightBlue);
        ExcelFont fontGreen = wb.createFont();
        fontGreen.setKnownColor(ExcelColors.LightGreen);

        //给指定的Excel单元格添加普通批注
        CellRange range = sheet.getCellRange("G3");
        range.getComment().setText("正式员工");
        range.getComment().setTextRotation(TextRotationType.TopToBottom);
        range.autoFitColumns();
        range.getComment().setVisible(true);//设置批注是否隐藏
        range.getComment().getFill().customPicture("D:\\Desktop\\Image.jpg");//背景图片填充
        //range.getComment().getFill().setForeColor(new Color(255,228,225));//颜色填充

        // 给指定的Excel单元格添加富文本批注
        range = sheet.getCellRange("G7");
        range.getRichText().setFont(0, 8, font);
        range.autoFitColumns();
        range.getComment().getRichText().setText("试用员工");
        range.getComment().getRichText().setFont(0, 4, fontGreen);
        range.getComment().getRichText().setFont(3, 4, fontBlue);

        //保存结果文档
        wb.saveToFile("output/AddComments.xlsx", ExcelVersion.Version2013);
        wb.dispose();

    }
}

批注添加效果：

【示例2】修改批注

import com.spire.xls.*;
public class ModifyComments {
    public static void main(String[] args) {
        //加载excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("D:\\Desktop\\AddComments.xlsx");
        //获取工作表
        Worksheet sheet = wb.getWorksheets().get(0);
        //获取指定单元格中的批注，设置新的批注文本、填充色
        sheet.getRange().get("G3").getComment().setText("个人使用");
        sheet.getRange().get("G7").getComment().setText("团队使用");
        //保存文档
        wb.saveToFile("output/ModifyComment.xlsx",ExcelVersion.Version2013);
        wb.dispose();
    }
}

批注修改效果：

【示例3】读取批注

import com.spire.xls.*;
import javax.imageio.ImageIO;
import java.awt.*;import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;

public class ReadComments {
    public static void main(String[] args) throws IOException {
        //加载excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("D:\\Desktop\\AddComments.xlsx");
        //获取工作表
        Worksheet sheet = wb.getWorksheets().get(0);
        //打印指定单元格的文本批注内容
        System.out.println("G3 的批注文本 = " + sheet.getCellRange("G3").getComment().getText());
        System.out.println("G7 的批注文本 = " + sheet.getCellRange("G7").getComment().getRichText().getRtfText());
        //获取指定单元格中批注背景颜色
        Color color = sheet.getRange().get("G3").getComment().getFill().getForeColor();
        System.out.print(color);
        //获取指定单元格中的批注背景图片
        BufferedImage image = sheet.getRange().get("G3").getComment().getFill().getPicture();
        ImageIO.write(image,"png",new File("output/ExtractedImage.png"));
    }
}

批注读取效果：

【示例4】复制批注

import com.spire.xls.*;
import java.awt.*;
import java.awt.image.BufferedImage;

public class CopyComments {
    public static void main(String[] args) {

        //加载Excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("D:\\Desktop\\AddComments.xlsx");

        //获取指定工作表
        Worksheet sheet = wb.getWorksheets().get(0);

        //获取源单元格批注内容
        CellRange range = sheet.getRange().get("G3");//获取指定单元格
        String commenttext = range.getComment().getText();//获取批注文本
        BufferedImage image  = range.getComment().getFill().getPicture();//获取批注填充图片
        // Object object = range.getComment().getFill().getForeColor();//获取批注填充色

        // 获取新的单元格，添加批注文本和图片（颜色）填充
        CellRange range1 = sheet.getRange().get("G12");
        range1.getComment().setText(commenttext);
        range1.getComment().getFill().customPicture(image," ");
        //range1.getComment().getFill().setForeColor((Color) object);

        // 保存文档
        wb.saveToFile("output/CopyComment.xlsx",ExcelVersion.Version2013);
        wb.dispose();
    }
}

批注复制效果：

【示例5】删除批注

import com.spire.xls.ExcelVersion;
import com.spire.xls.FileFormat;
import com.spire.xls.Workbook;
import com.spire.xls.Worksheet;

public class DeleteComments {
    public static void main(String[] args) {
        //加载Excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("D:\\Desktop\\AddComments.xlsx");
        //获取工作表
        Worksheet sheet = wb.getWorksheets().get(0);
        //获取指定单元格中的批注，并删除
        sheet.getRange().get("G3").getComment().remove();
        //保存文档
        wb.saveToFile("output/DeleteComment.xlsx", ExcelVersion.Version2013);
        wb.dispose();
    }
}

批注删除效果：

（本文完）