使用页头和页脚

页头和页脚,用来传达如文档标题,作者,创建日期或页码等环境信息.

访问节的页头

页头和页脚都链接到节上;这允许每个节有不同的页头和/或页脚.如,横向节的页头可能比纵向节宽.
每个节对象都有个访问该节的_Header对象的.header属性:

>>> document = Document()
>>> section = document.sections[0]
>>> header = section.header
>>> header
<docx.section._Header object at 0x...>

即使没有为该节定义头,_Header对象也总是在Section.header上.实际由_Header.is_linked_to_previous表示存在头:

>>> header.is_linked_to_previous
True

True值,表示_Header对象不包含头,且该节与上节有相同标题.

只需编辑_Header对象内容,即可给新文档加标题.
注意,与新文档一样,新页头已包含单个(空)段落:

>>> paragraph = header.paragraphs[0]
>>> paragraph.text = "Title of my document"

注意,加内容(甚至只是访问header.paragraphs)的行为加了头定义,并更改了.is_linked_to_previous的状态:

>>> header.is_linked_to_previous
False

一般使用精心放置的制表位,来完成多个"分区"标题.
插入("\t")制表符来分隔左对齐,居中对齐和右对齐的标题内容:

>>> paragraph = header.paragraphs[0]
>>> paragraph.text = "Left Text\tCenter Text\tRight Text"
>>> paragraph.style = document.styles["Header"]

可给.is_linked_to_previous属性赋值True来删除不需要的头:

>>> header.is_linked_to_previous = True
>>> header.is_linked_to_previous
True
//不可逆.

每个节都可有自己的头定义(但不必).
缺少头定义的节继承其前面节的标题._Header.is_linked_to_previous属性仅表示是否存在头定义.
默认缺少头定义.新文档没有定义页头,新插入的节也没有..is_linked_to_previous在此都为真.

可给.is_linked_to_previous属性赋值假来显式提供头定义.

>>> header.is_linked_to_previous
True
>>> header.is_linked_to_previous = False
>>> header.is_linked_to_previous
False