python-docx中文开发文档_python—docx 中文文档之表格类

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

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