批注是一种富文本注释，常用于为指定的 Excel 单元格添加提示或附加信息。 Free Spire.XLS for Java 为开发人员免费提供了在 Java 应用程序中对 Excel 文件添加和操作批注的功能。 本文将介绍如何使用Free Spire.XLS for Java在 Excel 文档中添加，读取和删除批注。
安装 首先你需要下载Spire.XLS JAR并将其作为依赖项添加到您的 Java 程序中。如果您使用的是 maven，您需要将以下依赖项添加到您的 pom.xml 文件中。
<repositories> ???????<repository> ???????????<id>com.e-iceblue</id> ???????????<name>e-iceblue</name> ???????????<url>http://repo.e-iceblue.com/nexus/content/groups/public/</url> ???????</repository></repositories><dependencies> ???<dependency> ???????<groupId>e-iceblue</groupId> ???????<artifactId>spire.xls.free</artifactId> ???????<version>2.2.0</version> ???</dependency></dependencies> 添加批注
下面的示例将演示如何使用免费的 Free Spire.XLS for Java 将批注添加到 Excel 文件中，并为批注文本中各个字符设置不同的字体颜色。
import com.spire.xls.*;public class AddComments { ???public static void main(String[] args){ ???????//新建 Excel 文档 ???????Workbook workbook = new Workbook(); ???????//获取第一张工作表 ???????Worksheet sheet = workbook.getWorksheets().get(0); ???????//设置工作表名称 ???????sheet.setName("批注"); ???????//添加文本到单元格[1,1] ???????CellRange range = sheet.getCellRange(1,1); ???????range.setText("添加批注:"); ???????//添加文本到单元格 [5,1] ???????CellRange range1 = sheet.getCellRange(5, 1); ???????range1.setText("批注"); ???????//添加批注到单元格 [5,1] ???????range1.getComment().setText("这是一个批注n 它可以是多行的。"); ???????//展示批注 ???????range1.getComment().setVisible(true); ???????//设置批注高度 ???????range1.getComment().setHeight(100); ???????//创建字体并设置字体颜色 ???????ExcelFont fontBlue = workbook.createFont(); ???????fontBlue.setKnownColor(ExcelColors.LightBlue); ???????ExcelFont fontGreen = workbook.createFont(); ???????fontGreen.setKnownColor(ExcelColors.LightGreen); ???????//设置批注文本中各个字符的字体 ???????range1.getComment().getRichText().setFont(0, 1, fontGreen); ???????range1.getComment().getRichText().setFont(2, 3, fontBlue); ???????range1.getComment().getRichText().setFont(4, 5, fontGreen); ???????//保存结果文档 ???????workbook.saveToFile("添加批注.xlsx", ExcelVersion.Version2013); ???}} ???读取批注 Free Spire.XLS for Java 支持读取所有批注以及与 Excel 工作表中指定单元格相关联的特定批注。
import com.spire.xls.*;public class ReadComments { ???public static void main(String[] args){ ???????//加载 Excel 文档 ???????Workbook workbook = new Workbook(); ???????workbook.loadFromFile("添加批注.xlsx"); ???????//获取第一张工作表 ???????Worksheet sheet = workbook.getWorksheets().get(0); ???????//打印工作表中所有的批注 ???????for(int i = 0; i < sheet.getComments().getCount(); i ++){ ???????????String comment = sheet.getComments().get(i).getText(); ???????????System.out.println(comment); ???????} ???????//打印与指定单元格相关联的批注 ??????//System.out.println(sheet.getCellRange(5,1).getComment().getText()); ???????}} ???删除批注 通过使用 Free Spire.XLS for Java 我们可以删除所有注释，也可以删除与 Excel 工作表中指定单元格相关联的特定批注。
import com.spire.xls.*;public class DeleteComments { ???public static void main(String[] args){ ???????//加载 Excel 文档 ???????Workbook workbook = new Workbook(); ???????workbook.loadFromFile("添加批注.xlsx"); ???????//获取第一张工作表 ???????Worksheet sheet = workbook.getWorksheets().get(0); ???????//删除工作表中所有批注 ???????for(int i = 0; i < sheet.getComments().getCount(); i ++){ ???????????sheet.getComments().get(i).remove(); ???????} ???????//删除与指定单元格相关联的批注 ???????sheet.getCellRange(5,1).getComment().remove(); ???????workbook.saveToFile("删除批注.xlsx", ExcelVersion.Version2013); ???????} ???}