首页/新闻资讯/正文详情

使用 Python 在 Excel 中添加和自定义文本框

发布时间:2026/11/19 19:59:17 来源:云帆数科 栏目:资讯中心
使用 Python 在 Excel 中添加和自定义文本框
在制作说明性表格、仪表盘或带批注的报表时仅靠单元格往往难以承载大段说明文字或自由排版的注释。Excel 的**文本框TextBox**提供了一种独立于单元格网格的容器它可以放置在任意位置、容纳多行文本、单独设置字体与背景并且不影响周边单元格的数据与公式。当需要在自动化流程中批量生成这类带注释的表格时用程序操控文本框比手工绘制更高效也更容易保持一致。本文将介绍如何用 Python 在 Excel 工作表中插入文本框并对其进行文本、对齐、字体、背景、内边距、自动换行等常见设置以及读取和替换文本框中的文字。为什么使用文本框而非普通单元格相比把说明文字直接写进单元格文本框有几个实际优点自由定位可以悬浮在任意位置不必依附于单元格的行列结构。独立样式字体、颜色、背景、边框都能单独设置与表格主体样式解耦。承载长文本适合放置说明、注释、图例等多行内容并通过自动换行保持排版。便于查找替换可以把文本框当作模板占位符的载体批量填充或替换文字。环境准备处理 Excel 文本框可以使用 Spire.XLS for Python通过 pip 安装pip install Spire.Xls在脚本中按如下方式导入主模块与通用模块from spire.xls import * from spire.xls.common import *插入文本框并设置文本与对齐在工作表中插入文本框使用sheet.TextBoxes.AddTextBox()参数依次是文本框所在的行、列、高度和宽度均以 Excel 内部单位计。插入后即可通过Text属性写入内容并通过HAlignment/VAlignment控制文字的水平与垂直对齐。from spire.xls import * from spire.xls.common import * workbook Workbook() workbook.Version ExcelVersion.Version2013 sheet workbook.Worksheets[0] # 在第 2 行第 2 列插入文本框高度 18、宽度 65 个单位 textbox sheet.TextBoxes.AddTextBox(2, 2, 18, 65) textbox.Text Spire.XLS for Python 是一款专业的 Excel Python API... textbox.HAlignment CommentHAlignType.Center textbox.VAlignment CommentVAlignType.Center workbook.SaveToFile(TextBox.xlsx, ExcelVersion.Version2013) workbook.Dispose()需要注意的是AddTextBox的前两个参数行、列决定文本框左上角锚定在哪一个单元格位置后两个参数决定它自身的尺寸这与单元格本身的宽高不是同一套单位设置时以实际显示效果为准。设置字体与背景文本框的文字外观通过富文本RichText机制设置可以精确控制从某个字符到另一个字符的区间字体。背景则通过Fill属性填充纯色。from spire.xls import * from spire.xls.common import * workbook Workbook() workbook.LoadFromFile(Template_Xls_5.xlsx) sheet workbook.Worksheets[0] shape sheet.TextBoxes[0] # 创建字体并设置属性 font workbook.CreateFont() font.FontName Century Gothic font.Size 10 font.IsBold True font.Color Color.get_Blue() # 将字体应用到整个文本框文本 rt RichText(shape.RichText) rt.SetFont(0, len(shape.Text) - 1, font) # 设置纯色背景 shape.Fill.FillType ShapeFillType.SolidColor shape.Fill.ForeKnownColor ExcelColors.BlueGray workbook.SaveToFile(SetFontAndBackground.xlsx, ExcelVersion.Version2013) workbook.Dispose()这里RichText.SetFont(start, end, font)的三个参数分别是起始索引、结束索引和字体对象索引从 0 开始、包含两端。如果只对整段文本统一设置样式用0到len(text) - 1覆盖全部字符即可需要局部高亮时再传入对应的区间即可。设置内边距与自动换行当文本框内文字较多时可以通过内边距属性控制文字与边框的间距并通过IsWrapText开启自动换行避免文字溢出或过度拥挤。from spire.xls import * from spire.xls.common import * workbook Workbook() workbook.LoadFromFile(Template_Xls_4.xlsx) sheet workbook.Worksheets[0] textbox sheet.TextBoxes.AddTextBox(4, 2, 100, 300) textbox.Text 在 Excel 中插入文本框并设置内边距 textbox.HAlignment CommentHAlignType.Center textbox.VAlignment CommentVAlignType.Center # 设置文本框内部边距 textbox.InnerLeftMargin 1 textbox.InnerRightMargin 3 textbox.InnerTopMargin 1 textbox.InnerBottomMargin 1 workbook.SaveToFile(SetInternalMarginOfTextbox.xlsx, ExcelVersion.Version2013) workbook.Dispose()对于已存在、文字较长的文本框直接开启自动换行即可from spire.xls import * from spire.xls.common import * workbook Workbook() workbook.LoadFromFile(TextBoxSampleB.xlsx) sheet workbook.Worksheets[0] shape sheet.TextBoxes[0] shape.IsWrapText True workbook.SaveToFile(TextBoxWithWrapText.xlsx, ExcelVersion.Version2013) workbook.Dispose()内边距单位为磅point数值越大文字离边框越远自动换行会让文本框随内容在设置好的尺寸内重新排列行两者配合能显著改善长文本的排版观感。读取与替换文本框中的文本文本框本质上是文档中的可访问对象遍历sheet.TextBoxes即可读取或批量替换其中的文字这非常适合做模板占位符填充。from spire.xls import * from spire.xls.common import * workbook Workbook() workbook.LoadFromFile(ReplaceTextInTextBox.xlsx) sheet workbook.Worksheets[0] # 遍历所有文本框替换指定文本 for tb in sheet.TextBoxes: if tb.Text ! and TAG_1 in tb.Text: tb.Text tb.Text.replace(TAG_1, Spire.XLS for .NET) workbook.SaveToFile(ReplaceTextInTextBox.xlsx, ExcelVersion.Version2013) workbook.Dispose()如果文档中文本框较多还可以为文本框命名之后按名称直接定位而不必依赖索引from spire.xls import * from spire.xls.common import * workbook Workbook() sheet workbook.Worksheets[0] textbox sheet.TextBoxes.AddTextBox(2, 2, 18, 65) textbox.Name FirstTextBox textbox.Text 需要被检索的说明文字 # 按名称获取文本框 found sheet.TextBoxes[FirstTextBox] print(found.Text) workbook.Dispose()命名方式在生成大量带标识的文本框时尤为实用例如把每个说明框命名为注释_客户信息注释_费用说明等后续维护就能精准命中目标。实用建议区分锚定与尺寸AddTextBox(row, col, height, width)中行列决定锚点高度宽度决定文本框自身大小二者单位不同初次使用建议小范围试值。替换前先判空遍历替换时加上tb.Text ! 的判断可避免空文本框引发的意外。字号与背景搭配浅色背景配深色文字、深色背景配浅色文字能提升文本框在密集报表中的可读性。及时释放资源批量处理多份工作簿后调用Dispose()避免文件句柄占用。总结本文围绕 Excel 文本框的常见操作介绍了插入文本框并设置文本对齐、设置字体与背景、调整内边距与自动换行以及读取和替换文本框文字四个方向。这些能力的统一入口是工作表的sheet.TextBoxes集合AddTextBox()负责创建Text与RichText负责内容与样式Fill负责背景Inner*Margin与IsWrapText负责排版而遍历或按名称访问则支撑了批量维护。在此基础上还可以把文本框与图表、形状、数据验证等功能组合例如为图表添加带说明的文本框、在仪表盘里用文本框承载动态提示语从而让自动生成的 Excel 文档既数据严谨又说明清晰

相关推荐

Claude Code + Hermes + Codex 多设备迁移指南
Claude Code + Hermes + Codex 多设备迁移指南

生成时间:2026-07-17 适用场景:在新电脑上复刻当前开发环境 目录 迁移清单共享知识库迁移Claude Code 迁移Hermes 迁移Codex 迁移工具迁移一键迁移脚本验证清单 1. 迁移清单 必须迁移(核心) 项目位置说明共享知识库D:/tools/sh… · 2026/9/9 10:12:11

Hermes Agent 全生命周期实战教程
Hermes Agent 全生命周期实战教程

以一个真实项目「DevShare 开发者社区」为例,完整演示如何用 Hermes 105 个技能,从 0 到 1 交付一个全栈项目。 适用环境:Hermes CLI(Windows 终端)/ 微信 目录 项目背景阶段 0:环境准备(5 分钟… · 2026/9/9 23:25:43

Vue3响应式API:computed、watch与watchEffect深度解析
Vue3响应式API:computed、watch与watchEffect深度解析

1. 为什么需要理解Vue3的响应式辅助工具在Vue3开发中,computed、watch和watchEffect是我们每天都会用到的核心API。但很多开发者(包括曾经的我)在使用时都存在一些误区:要么过度使用watch导致性能问题,要么该用compute… · 2026/9/18 0:08:27

个人电工证考试实操怕挂科?良心建议帮你稳过
个人电工证考试实操怕挂科?良心建议帮你稳过

个人电工证考试实操怕挂科?良心建议帮你稳过 实操考试心里没底怕挂科?这几乎是每个准备参加 个人电工证考试 的学员心里最真实的想法。特别是像济源房建工程这类需要频繁接触电力系统的岗位,一旦操作不规范,不仅影响施工进度,还可能带来严重的安全隐患… · 2026/11/19 19:58:48

雷山县监理电工证怎么考?郑州报考避坑指南全解析
雷山县监理电工证怎么考?郑州报考避坑指南全解析

雷山县监理电工证怎么考?郑州报考避坑指南全解析 工地太忙根本没时间复习考试,这不是你一个人的困扰,我身边有太多同行都遇到过类似问题。尤其是像雷山县监理电工证这样的特种作业操作证,不仅考试内容专业性强,而且流程繁琐,稍有不慎就可能耽误项目进度… · 2026/11/19 19:58:48

在滑县可以办电工证吗?低学历也能考,考前押题帮你过
在滑县可以办电工证吗?低学历也能考,考前押题帮你过

在滑县可以办电工证吗?低学历也能考,考前押题帮你过 你是不是也在担心自己学历不高,怕报不了电工证?其实, 在滑县是可以办电工证的… · 2026/11/19 19:58:48

吴江电工证培训时间多少钱?证书过期了不知道怎么复审延期
吴江电工证培训时间多少钱?证书过期了不知道怎么复审延期

吴江电工证培训时间多少钱?证书过期了不知道怎么复审延期 证书过期了不知道怎么复审延期,是不是你最近正在经历的烦恼?你是不是也遇到过,明明已经考了电工证,但几年过去,证书到期了却不知道该去哪儿办理复审?更糟的是,你发现 吴江电工证培训时间… · 2026/11/19 19:58:48

电工证到期了怎么换?报名电工证多久过期全解析,全国通用
电工证到期了怎么换?报名电工证多久过期全解析,全国通用

电工证到期了怎么换?报名电工证多久过期全解析,全国通用 实操考试心里没底怕挂科?很多电工朋友在报名考试时,最怕的就是挂科,但更大的焦虑是, 报名电工证多久过期… · 2026/11/19 19:58:48

高压电工证巡查岗网上查询别走弯路,先看这篇攻略
高压电工证巡查岗网上查询别走弯路,先看这篇攻略

高压电工证巡查岗网上查询别走弯路,先看这篇攻略 你是不是正为找工作发愁?别急, 高压电工证巡查岗 就是你的敲门砖。很多人因为不知道怎么 网上查询 证书状态,或者不了解报考流程,错失了不少机会。别再踩坑了,下面就把干货给你讲明白。… · 2026/11/19 19:57:48

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/19 17:40:37

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/19 17:50:07

姑苏区哪里考电工证好考前押题怎么找
姑苏区哪里考电工证好考前押题怎么找

姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12

罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南

罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12

罗定能考电工证吗 电工证含金量到底有多少?
罗定能考电工证吗 电工证含金量到底有多少?

罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码