表对象¶
表对象是使用 add_table()
方法对 Document
.
Table
对象¶
-
class
docx.table.
Table
(tbl, parent)[源代码]¶ WordprocessingML的代理类
<w:tbl>
元素。-
property
alignment
¶ 读/写。成员 WD_TABLE_ALIGNMENT 或无,指定此表在页边距之间的位置。
None
如果未指定任何设置,则会导致从样式层次结构继承有效值。
-
property
autofit
¶ True
如果列宽可以自动调整以提高单元格内容的适合性。False
如果表格布局是固定的。无论哪种情况,如果总列宽超过页面宽度,都将调整列宽。读/写布尔值。
-
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
指示该值是从样式层次结构继承的。
-
property
_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
如果没有设置显式宽度。
-