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
python官方文档中文版返回⽤EMU格式表⽰的这⼀列宽度。如果没有显式的设定,则返回none。
多⾏ 类_Rows objects的属性及⽅法
该表格中⾏实例的序列。⽀持 len(), ⽀持以迭代,下标的访问⽅式,以及切⽚。
table
1
返回对当前⾏实例集合所在单元格的引⽤。
多列 类_Columns objects的属性及⽅法
该表格中列实例的序列。⽀持 len(), ⽀持以迭代,下标的访问⽅式,以及切⽚。
table
1
返回对当前列实例集合所在单元格的引⽤。