基礎使用

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對象中的單元格cell進行操作：

            
              cell = table.cell(0, 1)

            
          

向其中添加內容：

            
              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() 查詢rows或columns的個數:

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

            
          

繼續添加行：

            
              row = table.add_row()

            
          

對于變長的表格，可以這樣做：

            
              # 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

            
          

設定表格樣式風格：

            
              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'