表对象

表对象是使用 add_table() 方法对 Document .

Table 对象

class docx.table.Table(tbl, parent)

WordprocessingML的代理类 <w:tbl> 元素。

add_column(width)

返回一个 _Column 的对象 width ，新添加到表的最右侧。

add_row()

返回A _Row 实例，新添加到表的最底部。

property alignment

读/写。

成员之一 WD_TABLE_ALIGNMENT 或无，指定此表在页边距之间的位置。 None 如果未指定设置，则导致从样式层次结构继承有效值。

property autofit

True 如果可以自动调整列宽以改善单元格内容的适配性。

False 如果表格布局是固定的。如果总列宽超过页面宽度，则在这两种情况下都会调整列宽。读/写布尔值。

cell(row_idx, col_idx)

返回 _Cell 实例对应于位于的表格单元格 row_idx ， col_idx 交集，其中(0，0)是最左侧的顶部单元格。

column_cells(column_idx)

位于的列中的单元格顺序 column_idx 在这张桌子上。

columns

_Columns 表示此表中列序列的实例。

row_cells(row_idx)

位于的行中的单元格顺序 row_idx 在这张桌子上。

rows

_Rows 实例包含此表中的行序列。

property style

读/写。一个 _TableStyle 对象，该对象表示应用于此表的样式。文档的默认表格样式(通常 Normal Table 如果表没有直接应用的样式，则返回。分配 None 设置为此属性将移除任何直接应用的表格样式，从而使其继承文档的默认表格样式。请注意，表格样式的样式名称与此稍有不同。

显示在用户界面中；如果出现连字符，则必须将其删除。例如, Light Shading - Accent 1 vbl.成为 Light Shading Accent 1 。

property table_direction

成员之一 WD_TABLE_DIRECTION 表示表格单元格的排序方向，例如 WD_TABLE_DIRECTION.LTR 。

None 指示该值继承自样式层次结构。

_Cell 对象

class docx.table._Cell(tc, parent)

表格单元格。

add_paragraph(text='', style=None)

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

如果存在， text 在一次运行中添加到段落中。如果指定，则为段落样式 style 是适用的。如果 style 未指定或已指定 None ，结果就像是应用了“正常”风格。请注意，单元格中文本的格式可能会受到表格样式的影响。 text 可以包含制表符 (\t )字符，这些字符被转换为用于选项卡的适当的XML形式。 text 还可以包括换行符 (\n )或回程 (\r )字符，每个字符都转换为换行符。

add_table(rows, cols)

在任何现有单元格内容之后返回新添加到此单元格的表，具有 rows 行和 cols 柱子。

因为Word需要一个段落元素作为每个单元格中的最后一个元素，所以会在表格之后添加一个空段落。

merge(other_cell)

返回通过跨越具有该单元格的矩形区域而创建的合并单元格 other_cell 作为对角线。

加薪 InvalidSpanError 如果单元格没有定义矩形区域。

property paragraphs

单元格中的段落列表。

表格单元格必须至少包含一个块级元素，并以段落结尾。默认情况下，新单元格包含单个段落。只读

property tables

单元格中的表列表，按其显示顺序排列。

只读。

property text: str

将此单元格的整个内容表示为文本字符串。

将字符串分配给此属性将用单个段落替换所有现有内容，该段落在单个运行中包含分配的文本。

property vertical_alignment

成员 WD_CELL_VERTICAL_ALIGNMENT 或者没有。

一个值 None 指示继承此单元格的垂直对齐方式。分配 None 导致删除任何显式定义的垂直对齐，恢复继承。

property width

EMU中此单元格的宽度，或 None 如果没有设置显式宽度。

_Row 对象

class docx.table._Row(tr, parent)

表行。

property cells: Tuple[_Cell]

序列 _Cell 与此行单元格对应的实例。

property height

返回A Length 表示此单元格高度的对象，或 None 如果没有设置明确的高度。

property height_rule

将此单元格的高度规则作为 WD_ROW_HEIGHT_RULE 枚举，或 None 如果没有设置明确的高度规则。

property table

参考 Table 此行所属的对象。

_Column 对象

class docx.table._Column(gridCol, parent)

表列。

property cells

序列 _Cell 与此列中的单元格对应的实例。

property table

参考 Table 此列所属的对象。

property width

EMU中此列的宽度，或 None 如果没有设置显式宽度。

_Rows 对象

class docx.table._Rows(tbl, parent)

顺序 _Row 与表中的行对应的对象。

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

property table

参考 Table 此行集合所属的对象。

_Columns 对象

class docx.table._Columns(tbl, parent)

顺序 _Column 与表中的列对应的实例。

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

property table

参考 Table 此列集合所属的对象。