pdf 文档中的查看器首选项是一项重要功能，可以显著提升文档的用户阅览体验。通过配置页面布局、显示模式和缩放级别等选项，可以确保文档查看者按照预期的方式查看文档，而无需手动调整。这对于商业报告、设计计划或教育材料等类型的文档尤其有用，一致的显示方式能够有效传递信息并留下专业印象。本文将介绍如何使用 spire.pdf for python 通过 python 代码设置 pdf 文档的查看器首选项。
安装 spire.pdf for python
本教程需要用到 spire.pdf for python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 windows 中。
pip install spire.pdf如果您不确定如何安装，请参考：如何在 windows 中安装 spire.pdf for python
设置 pdf 文档的查看器首选项
查看器首选项可以帮助文档创作者指定 pdf 文档被查看时的显示方式，包括页面布局、窗口布局以及显示模式。开发者可以使用 spire.pdf for python 提供的 viewerpreferences 类下的属性直接对查看器首选项进行设置。以下是详细操作步骤：
- 创建一个 pdfdocument 对象。
- 使用 pdfdocument.loadfromfile() 方法载入 pdf 文档。
- 使用 pdfdocument.viewerpreferences 属性获取 viewerpreferences 对象。
- 使用 viewerpreferences 类下的属性设置查看器首选项。
- 使用 pdfdocument.savetofile() 方法保存文档。
- python
from spire.pdf import *
# 创建一个 pdfdocument 对象
pdf = pdfdocument()
# 加载一个 pdf 文件
pdf.loadfromfile("示例.pdf")
# 获取查看器首选项
preferences = pdf.viewerpreferences
# 设置查看器首选项
preferences.fitwindow = true
preferences.centerwindow = true
preferences.hidemenubar = true
preferences.hidetoolbar = true
preferences.displaytitle = true
preferences.hidewindowui = true
preferences.pagelayout = pdfpagelayout.singlepage
preferences.bookmarkexpandorcollapse = true
preferences.printscaling = printscalingmode.appdefault
preferences.pagemode = pdfpagemode.usethumbs
# 保存文档
pdf.savetofile("output/查看器首选项.pdf")
pdf.close()
设置 pdf 默认打开页面及缩放比例
通过创建 pdf 动作并将其设置为在打开文档时执行的动作，开发人员可以配置额外的查看器首选项，如初始显示页面和默认缩放级别。以下是详细操作步骤：
- 创建一个 pdfdocument 对象。
- 使用 pdfdocument.loadfromfile() 方法载入 pdf 文档。
- 使用 pdfdocument.pages.get_item() 方法获取一个页面。
- 创建一个 pdfdestination 对象，并设置其位置和缩放比例。
- 使用 pdfdestination 对象创建一个 pdfgotoaction 对象。
- 通过 pdfdocument.afteropenaction 属性将此动作设置为文档打开时执行的动作。
- 使用 pdfdocument.savetofile() 方法保存文档。
- python
from spire.pdf import *
# 创建一个 pdfdocument 对象
pdf = pdfdocument()
# 加载一个 pdf 文件
pdf.loadfromfile("示例.pdf")
# 获取第二页
page = pdf.pages.get_item(1)
# 创建一个 pdfdestination 对象
dest = pdfdestination(page)
# 设置位置和缩放因子
dest.mode = pdfdestinationmode.location
dest.location = pointf(0.0, page.size.height / 2)
dest.zoom = 0.8
# 创建一个 pdfgotoaction 对象
action = pdfgotoaction(dest)
# 设置该动作为文档打开动作
pdf.afteropenaction = action
# 保存文档
pdf.savetofile("output/默认页面和缩放比例.pdf")
pdf.close()
申请临时 license
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。
