截面对象

提供对节属性（如页边距和页面方向）的访问。

Sections 对象

class docx.section.Sections(document_elm: CT_Document, document_part: DocumentPart)

序列 Section 与文档中的节相对应的对象。

支架 len() 、迭代和索引访问。

Section 对象

class docx.section.Section(sectPr: CT_SectPr, document_part: DocumentPart)

文档节，提供对节和页面设置设置的访问。

还提供对页眉和页脚的访问。

property bottom_margin: Length | None

读/写。本节中页面的下边距，以EMU为单位。

None 未指定下边距时。分配 None 删除所有底边距设置。

property different_first_page_header_footer: bool

如果此节显示不同的首页页眉和页脚，则为True。

读/写。第一页页眉和页脚的定义使用 first_page_header 和 first_page_footer 分别。

property even_page_footer: _Footer

_Footer 对象定义偶数页的页脚内容。

除非文档设置，否则忽略此页脚定义的内容 odd_and_even_pages_header_footer 设置为真。

property even_page_header: _Header

_Header 对象定义偶数页的标题内容。

此标头定义的内容将被忽略，除非文档设置 odd_and_even_pages_header_footer 设置为真。

property first_page_footer: _Footer

_Footer 对象定义此节第一页的页脚内容。

忽略此页脚定义的内容，除非属性 different_first_page_header_footer 设置为真。

property first_page_header: _Header

_Header 对象定义此节第一页的页眉内容。

除非属性 different_first_page_header_footer 设置为真。

footer

_Footer 对象，表示此节的默认页脚。

当启用了单独的奇数/偶数页脚时，默认页脚用于奇数页。它用于奇数页和偶数页。

property footer_distance: Length | None

从页面底部边缘到页脚底部边缘的距离。

读/写。 None 如果XML中不存在任何设置，则返回。

property gutter: Length | None

Length 以英制公制单位表示页间距大小的对象。

读/写。页面间距是添加到 inner 页边距可确保页面装订后页边距均匀。一般只用于双面和对开的装订文件。

此设置适用于此部分中的所有页面。

header

_Header 对象，表示此节的默认页眉。

当启用单独的奇数/偶数页眉时，默认页眉用于奇数编号的页面。它用于奇数页和偶数页。

property header_distance: Length | None

从页面顶部边缘到页眉顶部边缘的距离。

读/写。 None 如果XML中不存在任何设置，则返回。分配 None 导致使用默认值。

iter_inner_content() → Iterator[Paragraph | Table]

在此生成每个段落或表格对象 section 。

项目按文档顺序显示。

property left_margin: Length | None

Length 对象，以英制公制单位表示此节中所有页的左边距。

property orientation: WD_ORIENTATION

WD_ORIENTATION 指定此节的页面方向的成员。

其中之一 WD_ORIENT.PORTRAIT 或 WD_ORIENT.LANDSCAPE 。

property page_height: Length | None

此部分使用的总页面高度。

该值包含所有边距间隔值，例如边距。

页面方向被考虑在内，因此，例如，其期望值为 Inches(8.5) 当方向为横向时，用于信纸大小的纸张。

property page_width: Length | None

此部分使用的总页面宽度。

该值类似于“纸张大小”，并包括所有边缘间隔值，如页边距。

页面方向被考虑在内，因此，例如，其期望值为 Inches(11) 当方向为横向时，用于信纸大小的纸张。

property right_margin: Length | None

Length 对象，以英制公制单位表示此节中所有页的右边距。

property start_type: WD_SECTION_START

在本节开头插入的分页符类型(如果有)。

例如， WD_SECTION_START.ODD_PAGE 如果该部分应从下一个奇数页开始，则可能插入两个分页符而不是一个分页符。

property top_margin: Length | None

Length 对象，以英制公制单位表示此节中所有页的上页边距。

_Header and |_ 页脚|对象

class docx.section._Header

页眉，用于所有三种类型（默认、偶数页和第一页）。

请注意，与文档或表格单元格一样，页眉必须至少包含一个段落，而新的或“空”的页眉包含一个空段落。第一段可以作为 header.paragraphs[0] 为了向其中添加内容。使用 add_paragraph() 单独添加内容将在新添加的段落上方留下一个空段落。

add_paragraph(text='', style=None)

返回新添加到此容器中内容末尾的段落。

这一段有 text 在一次运行中，如果存在，并被赋予段落样式 style 。

如果 style 是 None ，则不应用任何段落样式，这与应用“正常”样式具有相同的效果。

add_table(rows, cols, width)

的返回表 width 拥有 rows 行和 cols 柱子。

该表被追加到该容器中内容的末尾。

width 在表列之间均匀分布。

property is_linked_to_previous: bool

True 如果此页眉/页脚使用上一节中的定义。

False 如果此页眉/页脚有明确的定义。

分配 True to this属性删除此节的页眉/页脚定义，使其“继承”上一节的相应定义。分配 False 导致为此节添加一个新的空定义，但前提是尚未存在定义。

property paragraphs

包含此容器中段落的列表，按文档顺序排列。

只读。

property tables

按文档顺序包含此容器中的表的列表。

只读。

class docx.section._Footer

页脚，用于所有三种类型（默认、偶数页和第一页）。

请注意，与文档或表格单元格一样，页脚必须至少包含一个段落，而新的或“空”的页脚包含一个空段落。第一段可以作为 footer.paragraphs[0] 为了向其中添加内容。使用 add_paragraph() 单独添加内容将在新添加的段落上方留下一个空段落。

add_paragraph(text='', style=None)

返回新添加到此容器中内容末尾的段落。

这一段有 text 在一次运行中，如果存在，并被赋予段落样式 style 。

如果 style 是 None ，则不应用任何段落样式，这与应用“正常”样式具有相同的效果。

add_table(rows, cols, width)

的返回表 width 拥有 rows 行和 cols 柱子。

该表被追加到该容器中内容的末尾。

width 在表列之间均匀分布。

property is_linked_to_previous: bool

True 如果此页眉/页脚使用上一节中的定义。

False 如果此页眉/页脚有明确的定义。

分配 True to this属性删除此节的页眉/页脚定义，使其“继承”上一节的相应定义。分配 False 导致为此节添加一个新的空定义，但前提是尚未存在定义。

property paragraphs

包含此容器中段落的列表，按文档顺序排列。

只读。

property tables

按文档顺序包含此容器中的表的列表。

只读。