python—docx 中文文档之表格类

时间:2024-03-08 20:41:41

python—docx 中文文档之表格类

 

 

表格 类Table objects

class docx.table.Table(tbl, parent)
  • 1

使用Document类中的.add_table() 方法创建表格实例。

表格 类Table objects的属性及方法

 add_column(width)
  • 1

返回一个建立在该表格最右端的列实例,参数width 指定宽度。

add_row()
  • 1

返回一个建立在该表格最下方的行实例。

alignment
  • 1

用来指定表格在页边距的位置,取值枚举类型WD_TABLE_ALIGNMENT 的成员。如果不指定,则取值none,这时会继承当前文件实例格式中的值。

autofit
  • 1

取值为True时,列宽会根据表格内容进行自动调整。 取值为False时,列宽固定。如果该表格列宽的总和超过了页面宽度,上述两种取值时候,列宽都会被调整。

cell(row_idx, col_idx)
  • 1

返回在row_idx 行,col_idx列的单元格实例(cell )。(0, 0) 是表格左上端的单元格。

column_cells(column_idx)
  • 1

返回表格第column_idx 行的 单元格实例(cell )序列。

columns
  • 1

返回该表格中的列实例的序列

row_cells(row_idx)
  • 1

表格中第row_idx行的 单元格实例(cell )序列。

rows
  • 1

返回该表格中的行实例的序列。

style
  • 1

可读可写。该表格使用的格式_TableStyle 实例。如果表格没有直接应用格式,则返回文件的默认格式(通常是 Normal )。取值 None 则移除该文件的直接应用格式。注意:表格格式名字不同于在用户界面的样子,如果出现连字符(-),那么必须被去掉。比如:Light Shading - Accent 1应该写成:Light Shading Accent 1

table_direction
  • 1

表格中的单元格放置方向,取值为枚举类型WD_TABLE_DIRECTION的成员,比如:WD_TABLE_DIRECTION.LTR。取值为None代表从当前文件实例的格式中继承的值。

单元格 类_Cell objects的属性及方法

add_paragraph(text=u\'\', style=None)
  • 1

返回建立在单元格内容后面的段落。如果出现这个方法,则在单次运行中,添加文本到段落中。参数style指定段落格式,如果参数style被指定,则应用该格式;如果没有被指定或者为None,则应用Normal格式。注意:文本的格式会被表格格式影响。参数text可以包含制表符,它会被转换成表格的合适的XML格式;可以包含换行符,回车符,这些会被转换成换行。

add_table(rows, cols)
  • 1

返回一个建立在单元格内容后的表格实例,有 rows行,cols列。一个空的段落被添加在表格后面,因为Word要求每个单元格中最后的元素是段落元素。

merge(other_cell)
  • 1

返回一个合并的单元格,该单元格是以将该单元格和参数other_cell指定单元格的作为对角线的矩形区域创建的。如果单元格没有定义矩形区域,则会引发异常:InvalidSpanError

paragraphs
  • 1

该单元格中的段落列表。一个表格的单元格要求包含至少一个段落。默认情况下,一个新的单元格中包含一个单独的段落。

tables
  • 1

该单元格中的表格列表。列表的顺序按照这些表格出现的顺序。

text
  • 1

返回文本字符串格式的单元格的所有内容。给这个字符串赋值,则会用赋的值替换单元格中的所有内容。

width
  • 1

返回用EMU格式表示的这一行宽度。如果没有显式的设定,则返回None

行 类_Row objects的属性及方法

表格的行。

cells
  • 1

这一行单元格的行实例列表。

height
  • 1

返回单元格高度的 length 实例。如果高度没有设定,则为None

height_rule
  • 1

返回单元格的高度规则,取值为枚举类型 WD_ROW_HEIGHT_RULE 的成员。如果没有显示设定高度规则,则返回None

table
  • 1

返回对当前行所在单元格的引用。

列 类_Column objects的属性及方法

cells
  • 1

这一列中所有单元格实例列表。

table
  • 1

返回对当前列所在单元格的引用。

width
  • 1

返回用EMU格式表示的这一列宽度。如果没有显式的设定,则返回none。

多行 类_Rows objects的属性及方法

该表格中行实例的序列。支持 len(), 支持以迭代,下标的访问方式,以及切片。

table
  • 1

返回对当前行实例集合所在单元格的引用。

多列 类_Columns objects的属性及方法

该表格中列实例的序列。支持 len(), 支持以迭代,下标的访问方式,以及切片。

table
  • 1

返回对当前列实例集合所在单元格的引用。