Python-docx 模块读写 Word 文档基础（二）：图片、表格，表格样式，章节设置，页眉页脚等
- 前言：
- 1、插入图片、设置大小：
- 2、插入表格、设置格式：
- 3、设置章节、页面设置等：
- 4、设置页眉页脚
- 结尾：
- 【Python与Office】专栏
前言：
上一篇博客介绍了 python-docx 模块如何 创建 word 文档、设置段落格式、字体格式等 ，本篇博客将对在日常使用 word 文档的其他操作进行介绍。
主要内容有：
1、插入图片、设置图片大小；
2、插入表格、设置表格样式、字体样式；
3、章节设置：页面大小、边距等；
4、设置页眉页脚。
1、插入图片、设置大小：
上篇博客简单的介绍了插入图片的方法，但是没介绍图片大小的设置方法：
# 导入模块
from docx import Document
# 此模块中包含 docx 中各类单位方法
from docx import shared
doc = Document()
doc.add_heading('python-docx 基础讲解（二）')
# 在文档中增加图片,并对设置图片大小
# 当只设置一个方向的长度（宽或高）时，另一方向会自动缩放
doc.add_picture('1.png',width=shared.Inches(1)) # 按英寸设置
doc.add_picture('1.png',height=shared.Cm(2)) # 按厘米设置
# 保存文件
doc.save('test2.docx')
注：当只设置图片一个方向的尺寸（宽或高）时，另一方向会自动缩放。
以上设置后文档截图：
2、插入表格、设置格式：
1、在文档中增加表格，并添加文字：
# 在文档中增加表格，并添加文字
table1 = doc.add_table(2,3) # 添加一个2行3列的表格，表格样式为None
"add_table(self, rows, cols, style=None):"
table1.cell(0,0).text = '0' # 给表格单元格赋值
# 获取表格对象所有单元格对象列表
print(table1._cells)
# ------运行结果------
# [<docx.table._Cell object at 0x000002131AF996C8>,
# <docx.table._Cell object at 0x000002131AF99608>,
# <docx.table._Cell object at 0x000002131AF99648>,
# <docx.table._Cell object at 0x000002131AF99688>,
# <docx.table._Cell object at 0x000002131AF99588>,
# <docx.table._Cell object at 0x000002131AF995C8>]
# ------运行结果------
# 对单元格对象设置文字
for i,cell in enumerate(table1._cells):
cell.text = str(i)
注：在word文档中增加表格时，会返回一个 table 对象。table对象中包含单元格 cell 对象，单元格写入数据就是设置 cell 对象的 text 值。
插入的表格截图：
2、设置表格样式：
从增加表格方法：add_table(self, rows, cols, style=None)，可以看出在创建表格时，就可以对表格样式进行设置。
可通过下面的方法获取 word 文档中 默认的表格样式：
# 获取所有表格样式
from docx.enum.style import WD_STYLE_TYPE
styles = doc.styles
for style in styles:
if style.type == WD_STYLE_TYPE.TABLE:
print(style)
''' 可设置的表格样式： _TableStyle('Normal Table') id: 187730312 _TableStyle('Table Grid') id: 187730312 _TableStyle('Light Shading') id: 187730376 _TableStyle('Light Shading Accent 1') id: 187730312 _TableStyle('Light Shading Accent 2') id: 187730376 _TableStyle('Light Shading Accent 3') id: 187730312 _TableStyle('Light Shading Accent 4') id: 187730376 _TableStyle('Light Shading Accent 5') id: 187730312 _TableStyle('Light Shading Accent 6') id: 187730376 _TableStyle('Light List') id: 187730312 ... 内容很多，可以自己尝试运行打印一下 '''
以上获取的表格样式，对应word文档里的这些表格样式：
英文也不复杂，大家可以对照一下。
设置表格样式：
表格在创建时可及可指定格式：
doc.add_table(2,3,style ='Table Grid' )
也可在创建后进行设置：
# 为表格设置统一样式：
table1.style = 'Table Grid'
设置表格样式后表格截图：
这样就比较接近日常使用的表格了。
3、其他表格常用方法：
# 表格设置自动调整列宽，（默认也为真）
table1.autofit = True
# 为表格对象增加列
table1.add_column(shared.Inches(3)) # 需指定宽度
"add_column(self, width):"
# 为表格对象增加行
table1.add_row() # 只能逐行添加
"add_row(self):"
获取表格对象的一些属性：
# 获取行对象
row0 = table1.rows[0]
print(row0)
# 获取列对象
col0 = table1.columns[0]
# 获取表格一行的单元格对象列表
row0_cells = table1.row_cells(0)
print(row0_cells)
# 运行结果
# [<docx.table._Cell object at 0x000000000B311C88>,
# <docx.table._Cell object at 0x000000000B311AC8>,
# <docx.table._Cell object at 0x000000000B311B08>,
# <docx.table._Cell object at 0x000000000B311A48>]
# 获取一列的单元格对象列表
col_0_cells = table1.column_cells(0)
print(col_0_cells)
# 运行结果
# [<docx.table._Cell object at 0x000000000B312F88>,
# <docx.table._Cell object at 0x000000000B312CC8>,
# <docx.table._Cell object at 0x000000000B31A108>]
4、设置表格内单元格对齐方式，合并单元格：
# 设置单元格对齐方式
# 垂直对齐方式
from docx.enum.table import WD_ALIGN_VERTICAL
table1.cell(0,0).vertical_alignment = WD_ALIGN_VERTICAL.TOP
# 合并单元格
cell_new = table1.cell(2,0).merge(table1.cell(2,1))
# 返回一个新单元格对象
print(cell_new)
# <docx.table._Cell object at 0x000000000B312F08>
# 要继续合并的话，可用此单元格再次使用 merge 方法
对表格增加行、列，合并单元格后表格截图：
5、设置单元格字体格式：
单元格内其实也是有 paragraph 对象的，即对单元格内字体设置方式，和对段落中文字格式设置方法一样。
cell_par = cell_new.paragraphs[0] # 获取到对象
# 设置对齐方式
from docx.enum.text import WD_ALIGN_PARAGRAPH
cell_par.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER
# 获取 run 对象
cell_run = cell_new.paragraphs[0].runs[0]
# 设置字体
cell_run.font.name = 'Times New Roman'
from docx.oxml.ns import qn
cell_run.font.element.rPr.rFonts.set(qn('w:eastAsia'),'楷体')
# 设置字体颜色
from docx.shared import RGBColor
cell_run.font.color.rgb = RGBColor(255,55,55) # 红色
表格截图：
3、设置章节、页面设置等：
章节 也是 word 文档中一个块级元素，相较于段落块级元素它的范围应该更大一点。一般来说：一个 word 文档包含多个章节、一个章节包含多个 run 块级元素。
一个word文档被建立时至少包含一个章节：
# word文档中章节 section 对象
sec = doc.sections
print(sec) # <docx.section.Sections object at 0x000000000B312E88>
print(len(sec)) # 1
1、新建章节：
# 新建一个章节
doc.add_section()
print(len(sec)) # 2
2、获取文档页面边距：
word 文档的页边距、页眉页脚的设置和章节对象有关：
# 文档页边距设置
# 获取、设置页面边距
sec0 = sec[0] # 获取章节对象
# 获取页面边距值：（单位为像素）
print('左边距：',sec0.left_margin)
# 左边距： 1143000
print('右边距：',sec0.right_margin)
# 右边距： 1143000
print('上边距：',sec0.top_margin)
# 上边距： 914400
print('下边距：',sec0.bottom_margin)
# 下边距： 914400
print('页眉边距：',sec0.header_distance)
# 页眉边距： 457200
print('页脚边距：',sec0.footer_distance)
# 页脚边距： 457200
3、设置文档页面边距、页面大小：
# 设置页面高度、宽度
sec0.page_height = shared.Inches(15)
sec0.page_width = shared.Inches(10)
# 也可以设置页面的边距：
sec0.left_margin = shared.Inches(1)
sec0.right_margin = shared.Inches(1)
sec0.top_margin = shared.Inches(2)
sec0.bottom_margin = shared.Inches(2)
设置后的 word 文档截图：
4、设置页眉页脚
设置页面页脚时，先获取页眉页脚对象：
# 设置页眉
head0 = sec0.header # 返回页眉对象
font0 = sec0.footer # 返回页脚对象
print(head0)
# <docx.section._Header object at 0x000000000B312E08>
print(font0)
# <docx.section._Footer object at 0x000000000B312B88>
设置方法：
"在设置word文档的页眉页脚时，有一个非常重要的是否与前一节相同"
# 查看页眉是否和上节一直
print(head0.is_linked_to_previous) # 默认为 True
# 设置页眉
"页眉也是一个块级对象，里面也包含了 Paragraph 对象,"
"所以对齐方式，文字格式设置方式和前文介绍一致。"
print(head0.paragraphs)
head0_par = head0.paragraphs[0]
head0_par.add_run('页眉')
# 设置页脚
font0_par = font0.paragraphs[0]
font0_par.add_run('页脚')
# 注: 设置页脚按序列增加的方式暂未找到
页眉页脚设置效果图：
结尾：
以上就是本篇博客的全部内容，感谢阅读。
下一篇将会是 python-docx 模块读取 word 文档中各种信息方法的详细介绍，包括段落文本信息、表格文本信息、各类块级元素的格式信息等。
【Python与Office】专栏
该专栏会对 Python 的第三方模块，如：xlwt，xlrd，python-docx等，操作 Office 办公软件（Word Excel PPT）的方法进行详细讲解。同时也会搭配一些实例演练，一方面强化知识点的理解与运用，另一方面也希望能起到，引导读者进行思考：如何用 python 提高 offic 办公软件办公效率的作用。
感兴趣的朋友，可以点个 关注 或 收藏 。如在博客中遇到任何问题或有一些想法、需求，可留言或私信。
创作不易，你的支持是我最大的动力，感谢 ！
