基礎(chǔ)使用

1.創(chuàng)建一個(gè)document文檔對(duì)象

            
              from docx import Document
document = Document()

            
          

2.向文檔中添加段落

添加一段話：

            
              paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')
（調(diào)用后會(huì)返回一個(gè)Paragraphs段落對(duì)象的引用）

            
          

可將上面返回的對(duì)象作為一個(gè)游標(biāo)，在已有段落之前加入：

            
              prior_paragraph = paragraph.insert_paragraph_before('Lorem ipsum')

            
          

3.添加標(biāo)題

默認(rèn)為top-level標(biāo)題

            
              document.add_heading('The REAL meaning of the universe')

            
          

可由level參數(shù)指定標(biāo)題級(jí)別

            
              document.add_heading('The role of dolphins', level=2)

            
          

4.添加分頁符

            
              document.add_page_break()

            
          

5.添加列表

            
              table = document.add_table(rows=2, cols=2)
（返回一個(gè)Tables對(duì)象）

            
          

還可對(duì)Tables對(duì)象中的單元格cell進(jìn)行操作：

            
              cell = table.cell(0, 1)

            
          

向其中添加內(nèi)容：

            
              cell.text = 'parrot, possibly dead'

            
          

還可以一行行的操作：

            
              row = table.rows[1]
row.cells[0].text = 'Foo bar to you.'
row.cells[1].text = 'And a hearty foo bar to you too sir!'

            
          

并且rows和columns是可迭代的，例如：

            
              for row in table.rows:
    for cell in row.cells:
        print(cell.text)

            
          

用len() 查詢r(jià)ows或columns的個(gè)數(shù):

            
              row_count = len(table.rows)
col_count = len(table.columns)

            
          

繼續(xù)添加行：

            
              row = table.add_row()

            
          

對(duì)于變長(zhǎng)的表格，可以這樣做：

            
              # get table data -------------
items = (
    (7, '1024', 'Plush kittens'),
    (3, '2042', 'Furbees'),
    (1, '1288', 'French Poodle Collars, Deluxe'),
)

# add table ------------------
table = document.add_table(1, 3)

# populate header row --------
heading_cells = table.rows[0].cells
heading_cells[0].text = 'Qty'
heading_cells[1].text = 'SKU'
heading_cells[2].text = 'Description'

# 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

            
          

設(shè)定表格樣式風(fēng)格：

            
              table.style = 'LightShading-Accent1'

            
          

6.添加圖片

            
              document.add_picture('image-filename.png')

            
          

圖片大小，可直接設(shè)定寬高：

            
              from docx.shared import Inches
document.add_picture('image-filename.png',width=Inches(1.0))

            
          

7.設(shè)置段落風(fēng)格

可在創(chuàng)建paragraph時(shí)設(shè)定：

            
              document.add_paragraph('Lorem ipsum dolor sit amet.', style='ListBullet')

            
          

也可之后設(shè)定：

            
              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.')
(這個(gè)方法會(huì)返回一個(gè)Run對(duì)象)

            
          

可對(duì)Run對(duì)象設(shè)定是否加粗、傾斜

            
              paragraph.add_run('dolor').bold = True

            
          

is equivalent to:

            
              run = paragraph.add_run('dolor')
run.bold = True

            
          

9.設(shè)定字體樣式

            
              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'