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 天的临时许可证。