表对象

表对象是使用 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_idxcol_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 此列集合所属的对象。