表对象

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

Table 对象

class docx.table.Table(tbl, parent)

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

add_column(width)

返回A _Column 对象 宽度 ，新添加到表的最右侧。

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 在这张桌子上。

property columns

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

row_cells(row_idx)

行中的单元格序列 row_idx 在这张桌子上。

property rows

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

property style

读/写。A _TableStyle 对象，该对象表示应用于此表的样式。文档的默认表格样式（通常 Normal Table )如果表没有直接应用的样式，则返回。分配 None to此属性将删除任何直接应用的表样式，从而导致它继承文档的默认表样式。请注意，表格样式的样式名称与用户界面中显示的样式名称略有不同；如果出现连字符，则必须将其删除。例如， Light Shading - Accent 1 变成 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 一次添加到段落中。如果指定，则段落样式 风格 已应用。如果 风格 未指定或 None ，结果就好像应用了“普通”样式。请注意，单元格中文本的格式可能受表格样式的影响。 text 可以包含制表符 (\t )字符，这些字符将转换为选项卡的适当XML格式。 text 也可以包括换行符 (\n ）或回车 (\r )字符，每个字符都转换为换行符。

add_table(rows, cols)

返回在任何现有单元格内容之后新添加到此单元格的表，具有 rows 行和 cols 柱。因为Word要求每个单元格中的最后一个元素是paragraph元素，所以在表后面添加一个空段落。

merge(other_cell)

返回一个合并的单元格，该单元格是通过跨越具有此单元格的矩形区域和 other_cell 作为对角。加薪 InvalidSpanError 如果单元格没有定义矩形区域。

property paragraphs

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

property tables

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

property text

此单元格的全部内容作为文本字符串。为该属性指定字符串将用一个段落替换所有现有内容，该段落在一次运行中包含指定的文本。

property vertical_alignment

成员 WD_CELL_VERTICAL_ALIGNMENT 或者没有。

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

property width

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

_Row 对象

class docx.table._Row(tr, parent)

表格行

property cells

序列 _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 此列集合所属的对象。