pdf 书签是优化阅读导航的关键工具。展开书签时，用户点击标题即可跳转至相关章节并展示下级目录，实现对文档深度结构的直观访问与定位。而折叠书签则可一键隐藏当前层级下的所有子书签信息，简化视图并聚焦更高层次结构。这两种操作协同作用，显著提升复杂、多层次 pdf 文档的阅读效率和体验。本文将介绍如何使用 以编程方式展开和折叠 pdf 中的书签。
安装 spire.pdf for python
本教程需要 spire.pdf for python 和 plum-dispatch v1.7.4。您可以通过以下 pip 命令将它们轻松安装到 vs code中。
pip install spire.pdf如果您不确定如何安装，请参考此教程： 如何在 vs code 中安装 spire.pdf for python
python 展开或折叠所有书签
spire.pdf for python 提供了一个名为 bookmarkexpandorcollapse 的属性，用于展开或折叠书签。当该属性设置为 true 时，会自动展开所有书签；反之，若将其设置为 false，则会收起所有书签。以下为在 pdf 文档中展开书签的具体步骤说明。
- 创建一个 pdfdocument 类的实例。
- 使用 pdfdocument.loadfromfile() 方法加载 pdf 文档。
- 使用 bookmarkexpandorcollapse属性展开 pdf 中所有的书签。
- 使用 pdfdocument.savetofile() 方法保存文档。
- python
from spire.pdf.common import *
from spire.pdf import *
# 创建一个 pdfdocument 对象
doc = pdfdocument()
# 加载一个 pdf 文件
doc.loadfromfile("书签.pdf")
# 将 bookmarkexpandorcollapse 设置为 true 以展开所有书签，设置为 false 以折叠所有书签
doc.viewerpreferences.bookmarkexpandorcollapse = true
# 保存文档
outputfile="展开书签1.pdf"
doc.savetofile(outputfile)
# 关闭文档
doc.close()
python 展开或折叠某个特定书签
如果需要仅展开或折叠某个特定书签，你可以获取到指定的书签，并设置其 expandbookmark 属性。以下是详细的步骤:
- 创建一个 pdfdocument 类的实例。
- 使用 pdfdocument.loadfromfile() 方法加载一个 pdf 文档。
- 通过 pdfdocument.bookmarks.get_item() 方法获取指定的书签。
- 使用 expandbookmark 属性展开书签。
- 使用 pdfdocument.savetofile() 方法保存结果文档。
- python
from spire.pdf.common import *
from spire.pdf import *
# 创建一个 pdfdocument 对象
doc = pdfdocument()
# 加载一个 pdf 文件
doc.loadfromfile("书签.pdf")
# 将 bookmarkexpandorcollapse 设置为 true，展开第三个书签
doc.bookmarks.get_item(1).expandbookmark = true
# 保存文档
outputfile="展开书签2.pdf"
doc.savetofile(outputfile)
# 关闭文档
doc.close()
申请临时 license
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。
