在 Excel 中，批注是一个功能，允许用户添加额外的细节或备注作为解释性说明。批注可以是文本或图像的形式。它使用户能够提供附加信息来解释或补充指定单元格中的数据。添加批注后，用户可以通过将鼠标悬停在带有批注的单元格上来查看批注的内容。这个功能提高了文档的可读性和理解性，帮助读者更好地理解和处理 Excel 中的数据。本文将介绍如何使用 Spire.XLS for Python 在 Python 中向 Excel 中添加批注。
安装 Spire.XLS for Python
本教程需要 Spire.XLS for Python 和 plum-dispatch v1.7.4。您可以通过以下 pip 命令将它们轻松安装到 Windows 中。
pip install Spire.XLS如果您不确定如何安装，请参考此教程： 如何在 Windows 中安装 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 天的临时许可证。
