列表是一种非常有用的工具，可以帮助我们以结构化和有序的方式呈现信息。无论是制作项目清单、步骤指南，还是总结重要观点，使用列表都可以显著提升文档的可读性和视觉吸引力，使读者更加轻松地浏览和理解文档的内容。本文将介绍如何使用 python 和 spire.doc for python 在 word 文档中创建各种类型的列表。
安装 spire.doc for python
本教程需要用到 spire.doc for python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 vs code 中。
pip install spire.doc如果您不确定如何安装，请参考：如何在 vs code 中安装 spire.doc for python
python 在 word 中创建编号列表
spire.doc for python 提供了 liststyle 类，用于创建编号列表样式或项目符号列表样式。创建后，你可以使用 paragraph.listformat.applystyle() 方法将列表样式应用到段落。创建编号列表的步骤如下：
- 创建 document 类的实例。
- 使用 document.addsection() 方法添加一个章节。
- 创建 liststyle 类的实例，指定列表类型为 numbered。
- 通过 liststyle.levels[index] 属性获取列表的特定级别，并通过 listlevel.patterntype 属性设置编号类型。
- 使用 document.liststyles.add() 方法将列表样式添加到文档中。
- 使用 section.addparagraph() 方法向文档添加多个段落。
- 使用 paragraph.listformat.applystyle() 方法将列表样式应用到特定段落。
- 通过 paragraph.listformat.listlevelnumber 属性指定列表级别。
- 使用 document.savetofile() 方法将文档保存为 word 文件。
- python
from spire.doc import *
from spire.doc.common import *
# 创建一个document对象
doc = document()
# 添加一个章节
section = doc.addsection()
# 创建一个编号列表样式
liststyle = liststyle(doc, listtype.numbered)
liststyle.name = "numberedlist"
liststyle.levels[0].patterntype = listpatterntype.decimalenclosedparen
liststyle.levels[0].textposition = 20
doc.liststyles.add(liststyle)
# 添加一个段落
paragraph = section.addparagraph()
textrange = paragraph.appendtext("所需的web开发技能：")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.bold = true
textrange.characterformat.fontsize = 12.0
paragraph.format.afterspacing = 5.0
# 添加一个段落并将编号列表样式应用于它
paragraph = section.addparagraph()
paragraph.appendtext("html")
paragraph.listformat.applystyle("numberedlist")
paragraph.listformat.listlevelnumber = 0
# 添加另外四个段落并将编号列表样式应用于它们
paragraph = section.addparagraph()
paragraph.appendtext("css")
paragraph.listformat.applystyle("numberedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
paragraph.appendtext("javascript")
paragraph.listformat.applystyle("numberedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
paragraph.appendtext("python")
paragraph.listformat.applystyle("numberedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
paragraph.appendtext("mysql")
paragraph.listformat.applystyle("numberedlist")
paragraph.listformat.listlevelnumber = 0
# 将文档保存到文件
doc.savetofile("编号列表.docx", fileformat.docx2016)
doc.dispose()
python 在 word 中创建项目符号列表
创建项目符号列表的过程与创建编号列表类似，主要区别在于需要将列表类型指定为 bulleted 并为其设置一个项目符号。以下是详细步骤：
- 创建 document 类的实例。
- 使用 document.addsection() 方法添加一个章节。
- 创建 liststyle 类的实例，将列表类型指定为 bulleted。
- 通过 liststyle.levels[index] 属性获取列表的特定级别，并通过 listlevel.bulletcharacter 属性设置项目符号。
- 使用 document.liststyles.add() 方法将列表样式添加到文档中。
- 使用 section.addparagraph() 方法向文档添加多个段落。
- 使用 paragraph.listformat.applystyle() 方法将列表样式应用到特定段落。
- 通过 paragraph.listformat.listlevelnumber 属性指定列表级别。
- 使用 document.savetofile() 方法将文档保存为 word 文件。
- python
from spire.doc import *
from spire.doc.common import *
# 创建一个document对象
doc = document()
# 添加一个章节
section = doc.addsection()
# 创建一个项目符号列表样式
liststyle = liststyle(doc, listtype.bulleted)
liststyle.name = "bulletedlist"
liststyle.levels[0].bulletcharacter = "\u00b7"
liststyle.levels[0].characterformat.fontname = "symbol"
liststyle.levels[0].textposition = 20
doc.liststyles.add(liststyle)
# 添加一个段落
paragraph = section.addparagraph()
textrange = paragraph.appendtext("计算机科学学科：")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.bold = true
textrange.characterformat.fontsize = 12.0
paragraph.format.afterspacing = 5.0
# 添加一个段落并将项目符号列表样式应用于它
paragraph = section.addparagraph()
textrange = paragraph.appendtext("数据结构")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulletedlist")
paragraph.listformat.listlevelnumber = 0
# 添加另外五个段落并将项目符号列表样式应用于它们
paragraph = section.addparagraph()
textrange = paragraph.appendtext("算法")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulletedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
textrange = paragraph.appendtext("计算机网络")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulletedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
textrange = paragraph.appendtext("操作系统")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulletedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
textrange = paragraph.appendtext("c编程")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulletedlist")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
textrange = paragraph.appendtext("计算理论")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulletedlist")
paragraph.listformat.listlevelnumber = 0
# 将文档保存到文件
doc.savetofile("项目符号列表.docx", fileformat.docx2016)
doc.dispose()
python 在 word 中创建多级编号列表
多级列表由至少两个不同的级别组成。你可以使用 liststyle.levels[index] 属性访问嵌套列表的特定级别，并为其设置编号类型和前缀。以下是创建多级编号列表的步骤：
- 创建 document 类的实例。
- 使用 document.addsection() 方法添加一个章节。
- 创建 liststyle 类的实例，将列表类型指定为编号列表。
- 通过 liststyle.levels[index] 属性获取列表的特定级别，并设置编号类型和前缀。
- 使用 document.liststyles.add() 方法将列表样式添加到文档中。
- 使用 section.addparagraph() 方法向文档添加多个段落。
- 使用 paragraph.listformat.applystyle() 方法将列表样式应用到特定段落。
- 通过 paragraph.listformat.listlevelnumber 属性指定列表级别。
- 使用 document.savetofile() 方法将文档保存为 word 文件。
- python
from spire.doc import *
from spire.doc.common import *
# 创建一个document对象
doc = document()
# 添加一个章节
section = doc.addsection()
# 创建一个编号列表样式，指定每个级别的编号前缀和模式类型
liststyle = liststyle(doc, listtype.numbered)
liststyle.name = "levelstyle"
liststyle.levels[0].patterntype = listpatterntype.arabic
liststyle.levels[0].textposition = 20.0
liststyle.levels[1].numberprefix = "%1."
liststyle.levels[1].patterntype = listpatterntype.arabic
liststyle.levels[2].numberprefix = "%1.%2."
liststyle.levels[2].patterntype = listpatterntype.arabic
doc.liststyles.add(liststyle)
# 添加一个段落
paragraph = section.addparagraph()
textrange = paragraph.appendtext("这是一个多级编号列表：")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.bold = true
textrange.characterformat.fontsize = 12.0
paragraph.format.afterspacing = 5.0
# 添加一个段落并将编号列表样式应用于它
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第一项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("levelstyle")
paragraph.listformat.listlevelnumber = 0
# 添加另外五个段落并将编号列表样式应用于它们
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第二项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("levelstyle")
paragraph.listformat.listlevelnumber = 0
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第一子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("levelstyle")
paragraph.listformat.listlevelnumber = 1
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第二子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.continuelistnumbering()
paragraph.listformat.applystyle("levelstyle")
paragraph = section.addparagraph()
textrange = paragraph.appendtext("子子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("levelstyle")
paragraph.listformat.listlevelnumber = 2
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第三项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("levelstyle")
paragraph.listformat.listlevelnumber = 0
# 将文档保存到文件
doc.savetofile("多级编号列表.docx", fileformat.docx2016)
doc.dispose()
python 在 word 中创建多级混合类型列表
要在多级列表中结合数字和符号项目符号，你需要创建单独的列表样式（编号和项目符号），并将它们应用于不同的段落。具体步骤如下：
- 创建 document 类的实例。
- 使用 document.addsection() 方法添加一个章节。
- 创建一个编号列表样式和一个项目符号列表样式。
- 使用 section.addparagraph() 方法向文档添加多个段落。
- 使用 paragraph.listformat.applystyle() 方法将不同的列表样式应用于不同的段落。
- 使用 document.savetofile() 方法将文档保存为word文件。
- python
from spire.doc import *
from spire.doc.common import *
# 创建一个document对象
doc = document()
# 添加一个章节
section = doc.addsection()
# 创建一个编号列表样式
numberedliststyle = liststyle(doc, listtype.numbered)
numberedliststyle.name = "numberedstyle"
numberedliststyle.levels[0].patterntype = listpatterntype.arabic
numberedliststyle.levels[0].textposition = 20
numberedliststyle.levels[1].patterntype = listpatterntype.lowletter
doc.liststyles.add(numberedliststyle)
# 创建一个项目符号列表样式
bulletedliststyle = liststyle(doc, listtype.bulleted)
bulletedliststyle.name = "bulltedstyle"
bulletedliststyle.levels[2].bulletcharacter = "\u002a"
bulletedliststyle.levels[2].characterformat.fontname = "symbol"
doc.liststyles.add(bulletedliststyle)
# 添加一个段落
paragraph = section.addparagraph()
textrange = paragraph.appendtext("这是一个多级混合列表：")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.bold = true
textrange.characterformat.fontsize = 12.0
paragraph.format.afterspacing = 5.0
# 添加一个段落并将编号列表样式应用于它
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第一项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("numberedstyle")
paragraph.listformat.listlevelnumber = 0
# 添加另外五个段落并应用不同的列表样式
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第一子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("numberedstyle")
paragraph.listformat.listlevelnumber = 1
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第二子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.listlevelnumber = 1
paragraph.listformat.applystyle("numberedstyle")
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第一子子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulltedstyle")
paragraph.listformat.listlevelnumber = 2
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第二子子项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("bulltedstyle")
paragraph.listformat.listlevelnumber = 2
paragraph = section.addparagraph()
textrange = paragraph.appendtext("第二项")
textrange.characterformat.fontname = "宋体"
textrange.characterformat.fontsize = 12.0
paragraph.listformat.applystyle("numberedstyle")
paragraph.listformat.listlevelnumber = 0
# 将文档保存到文件
doc.savetofile("多级混合列表.docx", fileformat.docx2016)
doc.dispose()
申请临时 license
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。
