基础使用:
1、创建一个document文档对象
2、向文档中添加段落
3、添加标题
4、添加分页符
5、添加列表
6、添加图片
7、设置段落风格
8、使用加粗和倾斜
9、设定字体样式
基础使用
1.创建一个document文档对象
from docx import Document document = Document()
2.向文档中添加段落 添加一段话:
paragraph = document.add_paragraph(‘Lorem ipsum dolor sit amet.’)
(调用后会返回一个Paragraphs段落对象的引用)
可将上面返回的对象作为一个游标,在已有段落之前加入:
prior_paragraph = paragraph.insert_paragraph_before(‘Lorem ipsum’)
3.添加标题
默认为top-level标题
document.add_heading(‘The REAL meaning of the universe’)
可由level参数指定标题级别
document.add_heading(‘The role of dolphins’, level=2)
4.添加分页符
document.add_page_break()
5.添加列表
table = document.add_table(rows=2, cols=2)
(返回一个Tables对象)
还可对Tables对象中的单元格cel l进行操作:
cel l = table. cel l(0, 1)
向其中添加内容:
cel l.tex t = ‘parrot, pos s ibl y dead’
还可以一行行的操作:
row = table.rows [1] row. cel l s [0].tex t = ‘Foo bar to you.’ row. cel l s [1].tex t = 'And a heart y foo bar to you too s ir!
并且rows和columns是可迭代的,
例如: for row in table.rows: for cell in row.cells: print(cell.text) 用len() 查询rows或columns的个数: row_count = len(table.rows) col_count = len(table.columns) 继续添加行: row = table.add_row()
5 .添加列表
对于变长的表格,可以这样做:
# g e t t a b l e d a t a -------------
i t e m s = (
( 7 , ' 1 0 2 4 ' , 'Pl u s h k i t t e n s '),
( 3 , ' 2 0 4 2 ' , ' F u r b e e s '),
( 1 , ' 1 2 8 8 ' , ' F r e n c h Po o d l e C o l l a r s , D e l u x e '),
)
# a d d t a b l e ------------------
t a b l e = d o c u m e n t . a d d _ t a b l e ( 1 , 3 )
# p o p u l a t e h e a d e r r o w --------
h e a d i n g _ c e l l s = t a b l e .r o w s [ 0 ] . c e l l s
h e a d i n g _ c e l l s [ 0 ] . t e x t = ' Q t y '
h e a d i n g _ c e l l s [ 1 ] . t e x t = 'SK U '
h e a d i n g _ c e l l s [ 2 ] . t e x t = ' D e s c ri p t i o n '
# add a data row for each item
for item in items:
cells = table.add_row().cells
cells[0].text = str(item.qty)
cells[1].text = item.sku
cells[2].text = item.desc
设定表格样式风格: table.style = ‘LightShading-Accent1’
6.添加图片
document.add_picture(‘image-filename.png’)
图片大小,可直接设定宽高:
from docx.shared import Inches
document.add_picture(‘image-filename.png’,width=Inches(1.0))
7.设置段落风格
可在创建paragraph时设定:
document.add_paragraph(‘Lorem ipsum dolor sit amet.’, style=‘ListBullet’)
也可之后设定:
paragraph = document.add_paragraph(‘Lorem ipsum dolor sit amet.’)
paragraph.style = ‘List Bullet’
8.使用加粗和倾斜
在通过add_paragraph()添加一段文字之后,还可以在这段中添加更多文字,
通 过add_run()
paragraph = document.add_paragraph('Lorem ipsum ')
paragraph.add_run(‘dolor sit amet.’)
(这个方法会返回一个Run对象)
可对Run对象设定是否加粗、倾斜
paragraph.add_run(‘dolor’).bold = True
is equivalent to:
run = paragraph.add_run(‘dolor’)
run.bold = True
9.设定字体样式
paragraph = document.add_paragraph('Normal text, ')
paragraph.add_run(‘text with emphasis.’, ‘Emphasis’)
is equivalent to:
paragraph = document.add_paragraph('Normal text, ')
run = paragraph.add_run(‘text with emphasis.’)
run.style = 'Emphasis