### 使用 `python-docx` 设置表格样式的教程与代码示例 #### 1. 表格创建与基础样式设置 在使用 `python-docx` 创建表格时，可以通过调整单元格内容、对齐方式、字体大小和颜色等来实现表格样式设置[^3]。 以下是一个完整的代码示例，展示如何创建一个表格并设置其样式： ```python from docx import Document from docx.shared import Pt, RGBColor from docx.enum.text import WD_ALIGN_PARAGRAPH # 创建一个新的文档对象 doc = Document() # 添加一个标题 doc.add_heading("表格样式设置示例", level=1) # 创建一个 3x3 的表格 table = doc.add_table(rows=3, cols=3) table.style = "Table Grid" # 设置表格样式为网格样式 # 遍历表格的每个单元格并设置内容和样式 for i, row in enumerate(table.rows): for j, cell in enumerate(row.cells): # 设置单元格内容 cell.text = f"行 {i+1}, 列 {j+1}" # 获取单元格中的段落并设置段落格式 paragraph = cell.paragraphs[0] paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER # 设置文本居中 # 设置字体样式 run = paragraph.runs[0] run.font.name = "Arial" # 设置字体为 Arial run.font.size = Pt(12) # 设置字体大小为 12 磅 if i == 0: # 如果是第一行，设置字体颜色为红色 run.font.color.rgb = RGBColor(255, 0, 0) # 保存文档 doc.save("table_style_example.docx") ``` #### 2. 设置表格列宽 通过 `columns.width` 属性可以设置表格的列宽。以下代码展示了如何设置表格的列宽[^3]。 ```python # 设置表格的列宽 for column in table.columns: for cell in column.cells: cell.width = Pt(100) # 设置每列宽度为 100 磅 ``` #### 3. 设置首行样式 为了突出显示表格的首行，可以单独设置其字体颜色、背景颜色或其他样式。以下代码展示了如何设置首行的水平和垂直居中对齐[^3]。 ```python # 设置首行样式 for cell in table.rows[0].cells: paragraph = cell.paragraphs[0] paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER # 水平居中 run = paragraph.runs[0] run.font.bold = True # 加粗字体 run.font.color.rgb = RGBColor(0, 0, 255) # 设置字体颜色为蓝色 ``` #### 4. 插入图片到单元格 如果需要在单元格中插入图片，可以使用 `add_picture()` 方法。以下代码展示了如何在单元格中插入图片。 ```python # 在第一个单元格中插入图片 cell = table.cell(1, 1) paragraph = cell.paragraphs[0] run = paragraph.add_run() run.add_picture('example.png', width=Pt(50), height=Pt(50)) # 插入图片并设置大小 ``` ### 注意事项 - 表格样式可以通过 `table.style` 属性进行设置，支持多种内置样式，例如 `"Table Grid"` 和 `"Light Shading"`。 - 单元格的对齐方式可以通过 `WD_ALIGN_PARAGRAPH` 枚举值进行设置。 - 字体颜色可以通过 `RGBColor` 类进行定义，取值范围为 `(0, 0, 0)` 到 `(255, 255, 255)`。