19-添加标题

15.3.7　添加标题

调用 add_heading() 将添加一个段落，并使用一种标题样式。在交互式环境中输入以下代码：

>>> doc = docx.Document()
>>> doc.add_heading('Header 0', 0)
<docx.text.Paragraph object at 0x00000000036CB3C8>
>>> doc.add_heading('Header 1', 1)
<docx.text.Paragraph object at 0x00000000036CB630>
>>> doc.add_heading('Header 2', 2)
<docx.text.Paragraph object at 0x00000000036CB828>
>>> doc.add_heading('Header 3', 3)
<docx.text.Paragraph object at 0x00000000036CB2E8>
>>> doc.add_heading('Header 4', 4)
<docx.text.Paragraph object at 0x00000000036CB3C8>
>>> doc.save('headings.docx')

add_heading() 的参数是一个标题文本的字符串，以及一个从 0 到 4 的整数。整数 0 表示标题是Title样式，这用于文档的顶部。整数 1 到 4 是不同的标题层次， 1 是主要的标题， 4 是最低层的子标题。 add_heading() 返回一个 Paragraph 对象，让你不必多花一步从 Document 对象中提取它。

得到的headings.docx文档如图15-10所示。