在 excel 中，批注是一个功能，允许用户添加额外的细节或备注作为解释性说明。批注可以是文本或图像的形式。它使用户能够提供附加信息来解释或补充指定单元格中的数据。添加批注后，用户可以通过将鼠标悬停在带有批注的单元格上来查看批注的内容。这个功能提高了文档的可读性和理解性，帮助读者更好地理解和处理 excel 中的数据。本文将介绍如何使用 spire.xls for python 在 python 中向 excel 中添加批注。
安装 spire.xls for python
本教程需要 spire.xls for python 和 plum-dispatch v1.7.4。您可以通过以下 pip 命令将它们轻松安装到 vs code 中。
pip install spire.xls如果您不确定如何安装，请参考此教程： 如何在 vs code 中安装 spire.xls for python
python 在 excel 中添加文本批注
spire.xls for python 允许用户通过调用 cellrange.addcomment() 方法在 excel 中添加带有文本的批注。以下是详细的步骤。
- 创建 workbook 类的对象。
- 使用 workbook.loadfromfile() 方法加载 excel 文件。
- 使用 workbook.worksheets[sheetindex] 属性获取所需的工作表。
- 使用 worksheet.range[] 属性获取指定的单元格。
- 设置批注的作者和内容，并使用 cellrange.addcomment() 方法将它们添加到获取的单元格中。
- 设置批注的字体。
- 使用 workbook.savetofile() 方法保存结果文件。
- python
from spire.xls import *
from spire.xls.common import *
# 输入文件路径
inputfile = "示例文档.xlsx"
# 输出文件路径
outputfile = "批注文本.xlsx"
# 创建一个workbook实例
workbook = workbook()
# 从文件加载名为"示例文档.xlsx"的excel文档
workbook.loadfromfile(inputfile)
# 获取第一个工作表
sheet = workbook.worksheets[0]
# 获取工作表中的指定范围（单元格b4）
range = sheet.range["b4"]
# 设置批注的作者
author = "张三"
# 设置批注的文本内容
text = "普通测试。"
# 添加批注到指定范围的单元格
comment = range.addcomment()
# 设置批注框宽度
comment.width = 200
# 设置批注可见性为true
comment.visible = true
# 设置批注的文本内容，包括作者和文本内容
comment.text = author ":\n" text
# 创建一个字体对象
font = workbook.createfont()
# 设置字体名称为"黑体"
font.fontname = "黑体"
# 设置字体颜色为黑色
font.knowncolor = excelcolors.black
# 设置字体为粗体
font.isbold = true
# 对批注的作者部分应用自定义字体样式
comment.richtext.setfont(0, len(author), font)
# 将带有批注的工作簿保存为新的excel文件，使用excel版本2013格式
workbook.savetofile(outputfile, excelversion.version2013)
workbook.dispose()
python 在 excel 中添加带有图片的批注
此外，spire.xls for python 还允许用户使用 cellrange.addcomment() 和 excelcommentobject.fill.custompicture() 方法，在 excel 中向指定单元格添加带有图片的批注。以下是详细的步骤。
- 创建 workbook 类的对象。
- 使用 workbook.loadfromfile() 方法加载 excel 文件。
- 使用 workbook.worksheets[sheetindex] 属性获取所需的工作表。
- 使用 worksheet.range[] 属性获取指定的单元格，并为其设置文本。
- 使用 cellrange.addcomment() 方法将批注添加到获取的单元格中。
- 加载图像，并通过调用 excelcommentobject.fill.custompicture() 方法将其填充到批注中。
- 设置批注的高度和宽度。
- 使用 workbook.savetofile() 方法保存结果文件。
- python
from spire.xls import *
from spire.xls.common import *
# 输入图片文件路径
inputimagefile = "logo.png"
# 输入文件路径
inputfile = "示例文档.xlsx"
# 输出文件路径
outputfile = "批注图片.xlsx"
# 创建一个workbook实例
workbook = workbook()
# 从文件加载名为"示例文档.xlsx"的excel文档
workbook.loadfromfile(inputfile)
# 获取第一个工作表
sheet = workbook.worksheets[0]
# 获取工作表中的指定范围（单元格c6）
range = sheet.range["c6"]
# 设置指定范围的文本内容为"e-iceblue"
range.text = "e-iceblue"
# 在指定范围的单元格上添加批注
comment = range["c6"].addcomment()
# 从文件加载名为"logo.png"的图片
image = image.fromfile(inputimagefile)
# 使用自定义图片填充批注框
comment.fill.custompicture(image, "logo.png")
# 设置批注框的高度为图片的高度
comment.height = image.height
# 设置批注框的宽度为图片的宽度
comment.width = image.width
# 设置批注框可见性为true
comment.visible = true
# 将带有批注图片的工作簿保存为新的excel文件，使用excel版本2016格式
workbook.savetofile(outputfile, excelversion.version2016)
workbook.dispose()
申请临时 license
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。
