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
,则应用Norma
l格式。注意:文本的格式会被表格格式影响。参数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
返回对当前列实例集合所在单元格的引用。