调整 Word 表格的列宽是提升文档视觉效果与阅读流畅度的重要手段。恰当的列宽设计，能够有效防止文本过长导致的阅读障碍，特别是在信息量大的表格中，这一点尤为重要。在 Word 中，用户拥有两种灵活的调整方式来实现这一目标：基于百分比的调整和固定数值设定。选择百分比作为调整依据，能够让表格自动适应各种屏幕尺寸，保证内容排列的整洁有序，从而显著优化阅读体验。而采用固定数值进行设置，则赋予了用户对表格结构的精准掌控能力，确保了数据对齐的一致性和整体的专业感，特别适用于需要严格遵循特定格式或涉及复杂布局的文档设计场景。本文将介绍如何使用 Spire.Doc for Python 在 Python 项目中基于百分比与固定值的设置方法来设置 Word 表格列宽。
安装 Spire.Doc for Python
本教程需要用到 Spire.Doc for Python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 VS Code 中。
pip install Spire.DocPython 基于百分比设置 Word 表格列宽
当您选择使用百分比值来设置 Word 表格的列宽时，首先需要确保整个表格的宽度类型被指定为百分比模式 Table.PreferredWidth=PreferredWidth(WidthType.Percentage, 100)，然后依次遍历每个列设置相同或不同的百分比值的宽度。以下是详细的步骤：
- 创建一个 Document 对象。
- 使用 Document.LoadFromFile() 方法加载一个文档。
- 使用 Document.Sections.get_Item(0) 获取文档的第一个节。
- 使用 Section.Tables.get_Item(0) 获取节中的第一个表格。
- 使用 for 循环遍历表格中的所有表格行。
- 使用 TableRow.Cells.get_Item(0).SetCellWidth(value, CellWidthType.Percentage) 方法为不同列的单元格设置百分比值的列宽。
- 使用 Document.SaveToFile() 方法保存到 Word 文档。
- Python
from spire.doc import *
from spire.doc.common import *
# 创建一个新的Document对象
doc = Document()
# 加载名为"示例.docx"的文档
doc.LoadFromFile("示例.docx")
# 获取文档的第一个Section
section = doc.Sections.get_Item(0)
# 获取ection中的第一个Table
table1 = section.Tables.get_Item(0)
table =(Table)(table1)
# 创建一个PreferredWidth对象，设置宽度类型为百分比，并设置宽度值为100%
percentageWidth = PreferredWidth(WidthType.Percentage, 100)
# 设置Table的首选宽度为上面创建的PreferredWidth对象
table.PreferredWidth = percentageWidth
# 遍历Table的所有行
for i in range(table.Rows.Count):
# 获取当前行
tableRow = table.Rows.get_Item(i)
# 设置第一列单元格的宽度为34%，类型为百分比
tableRow.Cells.get_Item(0).SetCellWidth(34, CellWidthType.Percentage)
# 设置第二列单元格的宽度为33%，类型为百分比
tableRow.Cells.get_Item(1).SetCellWidth(33, CellWidthType.Percentage)
# 设置第三列单元格的宽度为33%，类型为百分比
tableRow.Cells.get_Item(2).SetCellWidth(33, CellWidthType.Percentage)
# 保存修改后的文档，并指定文件格式为Docx2016
doc.SaveToFile("以百分比值设置列宽.docx", FileFormat.Docx2016)
# 关闭文档
doc.Close()
Python 基于固定值设置 Word 表格列宽
在使用固定值来精细化控制 Word 表格列宽时，首先应确保表格的布局类型被明确设定为“固定”模式，Table.TableFormat.LayoutType = LayoutType.Fixed，然后依次遍历每个列设置相同或不同的固定值的宽度。以下是详细的步骤：
- 创建一个 Document 对象。
- 使用 Document.LoadFromFile() 方法加载一个文档。
- 使用 Document.Sections.get_Item(0) 获取文档的第一个节。
- 使用 Section.Tables.get_Item(0) 获取节中的第一个表格。
- 使用 for 循环遍历表格中的所有表格行。
- 使用 TableRow.Cells.get_Item(0).SetCellWidth(value, CellWidthType.Point) 方法为不同列的单元格设置固定值的列宽。
- 使用 Document.SaveToFile() 方法保存到 Word 文档。
- Python
from spire.doc import *
from spire.doc.common import *
# 创建一个新的Document对象
doc = Document()
# 加载名为"示例.docx"的文档
doc.LoadFromFile("示例.docx")
# 获取文档的第一个Section
section = doc.Sections.get_Item(0)
# 获取Section中的第一个Table
table = section.Tables.get_Item(0)
# 设置表格布局类型为固定
table.TableFormat.LayoutType = LayoutType.Fixed
# 设置表格大小调整方式为非自动
table.TableFormat.IsAutoResized = False
# 获取左页边距
leftMargin = section.PageSetup.Margins.Left
# 获取右页边距
rightMargin = section.PageSetup.Margins.Right
# 计算页面宽度减去左右边距
pageWidth = section.PageSetup.PageSize.Width - leftMargin - rightMargin
# 遍历Table的所有行
for i in range(table.Rows.Count):
# 获取当前行
table_row = table.Rows.get_Item(i)
# 设置第一列单元格宽度为页面宽度的34%
table_row.Cells.get_Item(0).SetCellWidth(float(pageWidth * 0.34), CellWidthType.Point)
# 设置第二列单元格宽度为页面宽度的33%
table_row.Cells.get_Item(1).SetCellWidth(float(pageWidth * 0.33), CellWidthType.Point)
# 设置第三列单元格宽度为页面宽度的33%
table_row.Cells.get_Item(2).SetCellWidth(float(pageWidth * 0.33), CellWidthType.Point)
# 保存修改后的文档，并指定文件格式为Docx2016
doc.SaveToFile("以固定值设置列宽.docx", FileFormat.Docx2016)
# 关闭文档
doc.Close()
申请临时 License
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。
