在 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 添加文本框
您可以使用 Worksheet.TextBoxes.AddTextBox() 方法将文本框添加到工作表的指定位置。TextBox 对象具有一组属性,可以设置文本框的文本和格式。使用 Spire.XLS for Python 创建文本框的详细步骤如下:
- 创建一个 Workbook 对象。
- 通过 Workbook.Worksheets[index] 属性获取特定的工作表。
- 使用 Worksheet.TextBoxes.AddTextBox() 方法在指定位置向工作表添加文本框。
- 通过 TextBox.Text 属性设置文本框的文本。
- 通过 TextBox 对象下的其他属性设置文本的格式。
- 使用 Workbook.SaveToFile() 方法将工作簿保存为 Excel 文件。
- Python
from spire.xls import *
from spire.xls.common import *
# 创建 Workbook 对象
workbook = Workbook()
# 获取第一个工作表对象
sheet = workbook.Worksheets[0]
# 添加文本框,指定位置和大小
textBox = sheet.TextBoxes.AddTextBox(5, 3, 120, 330)
# 设置文本框填充类型为纯色填充
textBox.Fill.FillType = ShapeFillType.SolidColor
# 设置文本框填充颜色为25%的灰色
textBox.Fill.ForeKnownColor = ExcelColors.Gray25Percent
# 设置文本框的文本内容
textBox.Text = "这是Excel中的一个文本框。"
# 设置文本框水平居中对齐
textBox.HAlignment = CommentHAlignType.Center
# 设置文本框垂直居中对齐
textBox.VAlignment = CommentVAlignType.Center
# 创建字体对象
font = workbook.CreateFont()
# 设置字体名称为宋体
font.FontName = "宋体"
# 设置字体大小为18磅
font.Size = 18
# 设置字体为粗体
font.IsBold = True
# 设置字体颜色为蓝色
font.Color = Color.get_Blue()
# 获取文本框的 RichText 对象
richText = textBox.RichText
# 构造 RichTextHelper 对象
rt = RichText(richText)
# 设置文本框中所有字符的字体样式为刚创建的字体对象
rt.SetFont(0, len(textBox.Text) - 1, font)
# 将更改后的工作簿保存为文件,使用 ExcelVersion.Version2016 格式
workbook.SaveToFile('添加文本框.xlsx', ExcelVersion.Version2016)
# 释放 Workbook 对象所占用的资源
workbook.Dispose()
Python 更新 Excel 中的文本框
您可以通过 Worksheet.TextBoxes[index] 属性访问特定的文本框,并可以通过 TextBox.Text 属性获取或修改文本框内的文本。以下是使用 Spire.XLS for Python 更新文本框的步骤:
- 创建一个 Workbook 对象。
- 使用 Workbook.LoadFromFile() 方法加载一个 Excel 文件。
- 通过 Workbook.Worksheets[index] 属性获取特定的工作表。
- 使用 Worksheet.TextBoxes.AddTextBox() 方法在指定位置向工作表添加文本框。
- 通过 TextBox.Text 属性重置文本框的文本。
- 使用 Workbook.SaveToFile() 方法将工作簿保存为另一个 Excel 文件。
- Python
from spire.xls import *
from spire.xls.common import *
# 创建 Workbook 对象
workbook = Workbook()
# 从文件夹加载Excel文件
workbook.LoadFromFile('文本框.xlsx')
# 获取第一个工作表对象
sheet = workbook.Worksheets[0]
# 获取第一个文本框对象
tb = sheet.TextBoxes[0]
# 更新文本框的文本内容
tb.Text = "此文本框中的文本已更改。"
# 将更改后的工作簿保存为文件,使用 ExcelVersion.Version2016 格式
workbook.SaveToFile('更新文本框.xlsx', ExcelVersion.Version2016)
# 释放 Workbook 对象所占用的资源
workbook.Dispose()
Python 删除 Excel 中的文本框
要删除特定的文本框,您可以使用 Worksheet.TextBox[index].Remove() 方法。具体步骤如下:
- 创建一个 Workbook 对象。
- 使用 Workbook.LoadFromFile() 方法加载一个 Excel 文件。
- 通过 Workbook.Worksheets[index] 属性获取特定的工作表。
- 使用 Worksheet.TextBoxes[index].Remove() 方法删除特定的文本框
- 使用 Workbook.SaveToFile() 方法将工作簿保存为另一个 Excel 文件。
- Python
from spire.xls import *
from spire.xls.common import *
# 创建 Workbook 对象
workbook = Workbook()
# 从文件夹加载Excel文件
workbook.LoadFromFile('文本框.xlsx')
# 获取第一个工作表对象
sheet = workbook.Worksheets[0]
# 删除工作表中的第一个文本框对象
sheet.TextBoxes[0].Remove()
# 将更改后的工作簿保存为文件,使用 ExcelVersion.Version2016 格式
workbook.SaveToFile('删除文本框.xlsx', ExcelVersion.Version2016)
# 释放 Workbook 对象所占用的资源
workbook.Dispose()
申请临时 License
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。