批注，是作者或审阅者给文档添加的注释或注解。通过查看批注，可以更加详细地了解某些文字的背景。除了直接添加文本信息外，还可为文本信息填充背景图片使其更具丰富性和美观性。本文将通过使用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();
}
}
批注删除效果：
（本文完）
