用Python在PDF文档中创建动作

PDF格式因其跨平台兼容性和丰富的功能集而成为许多行业中的首选文件格式。其中，PDF中的动作（Action）功能尤为突出，它允许开发者嵌入交互式元素，如链接、按钮或是更复杂的脚本，从而显著提升文档的互动性和功P能性。通过使用Python这样的强大编程语言来创建这些动作，不仅可以自动化文档处理流程，还能实现各种复杂的文档操作，极大地丰富了PDF文档的应用场景，使得PDF文档不再仅仅是静态的内容展示，而是能够更好地服务于用户需求和业务流程。本文将介绍如何使用Python在PDF文档中创建动作。

文章目录

- 用Python在PDF中创建导航跳转动作
- 用Python在PDF中创建声音动作
- 用Python在PDF中创建JavaScript动作

本文所使用的方法需要用到Spire.PDF for Python，Python：pip install Spire.PDF。

用Python在PDF中创建导航跳转动作

库中的PdfGoToAction类代表导航跳转动作，可以跳转到文档内指定页面的指定位置，同时可自定义跳转后的页面缩放。一下是利用此类在PDF文档中创建导航跳转动作的操作步骤：

导入所需模块。
创建PdfDocument类，并使用PdfDocument.LoadFromFile()方法载入PDF文件。
使用PdfDocument.Pages.get_Item()方法获取一个页面。
创建一个PdfDestination实例来设置跳转目标位置以及跳转后的页面缩放。
用PdfDestination实例创建一个PdfGoToAction实例。
用PdfGoToAction实例在指定位置创建一个PdfActionAnnotation实例，并使用该类下的方法设置注释的颜色。
使用PdfPageBase.Annotations.Add()方法将注释添加到页面上。
使用PdfPageBase.Canvas.DrawString()方法在注释位置绘制导航提示文字。
使用PdfDocument.SaveToFile()方法保存文档。
释放资源。

代码示例

from spire.pdf import *# 创建PdfDocument类的一个实例并加载一个PDF文档
pdf = PdfDocument()
pdf.LoadFromFile("示例.pdf")# 获取第二页
page = pdf.Pages.get_Item(1)# 创建一个PdfDestination实例并设置其属性
destination = PdfDestination(pdf.Pages.get_Item(0))
destination.Location = PointF(0.0, 0.0)
destination.Mode = PdfDestinationMode.Location
destination.Zoom = 0.8# 创建一个PdfGoToAction实例
action = PdfGoToAction(destination)# 创建一个PdfActionAnnotation实例
rect = RectangleF.FromLTRB(70, pdf.PageSettings.Size.Height - 120, 140, pdf.PageSettings.Size.Height - 100)
annotation = PdfActionAnnotation(rect, action)
annotation.Color = PdfRGBColor(Color.get_Red())# 将注释添加到第二页
page.Annotations.Add(annotation)# 绘制按钮的文字
font = PdfTrueTypeFont("HarmonyOS Sans SC", 14.0, PdfFontStyle.Regular, True)
stringFormat = PdfStringFormat(PdfTextAlignment.Center)
page.Canvas.DrawString("转到第一页", font, PdfBrushes.get_Red(), rect, stringFormat)# 保存文档
pdf.SaveToFile("output/PDF添加导航动作.pdf")
pdf.Close()

结果
Python PDF中创建导航跳转动作

用Python在PDF中创建声音动作

PdfSoundAction类表示一个音频动作，可以用于嵌入音频到PDF文档中，并在用户执行指定操作时播放音频，如点击动作注释时和打开文件时。以下是在PDF文档中创建声音动作的操作步骤：

导入所需模块。
创建PdfDocument类，并使用PdfDocument.LoadFromFile()方法载入PDF文件。
使用指定音频文件创建PdfSoundAction实例。
使用PdfSoundAction类下的属性设置音频播放参数。
使用PdfSoundAction.Sound下的属性设置音频参数。
使用PdfDocument.Pages.get_Item()方法获取一个页面。
使用PdfPageBase.Canvas.DrawImage()方法在页面指定位置绘制音频播放图标。
用PdfSoundAction实例创建一个PdfActionAnnotation实例，并使用PdfPageBase.Annotations.Add()方法将其添加到页面的音频播放图标位置。
还可以直接使用PdfDocument.AfterOpenAction属性直接将声音动作设置为文档开启时执行的动作。
使用PdfDocument.SaveToFile()方法保存文档。
释放资源。

代码示例

from spire.pdf import *# 创建PdfDocument实例并加载PDF文件
pdf = PdfDocument()
pdf.LoadFromFile("示例2.pdf")# 获取文档的第一页
page = pdf.Pages.get_Item(0)# 使用声音文件路径创建PdfSoundAction实例
soundAction = PdfSoundAction("Wave.wav")# 设置音频参数
soundAction.Sound.Bits = 16
soundAction.Sound.Channels = PdfSoundChannels.Stereo
soundAction.Sound.Encoding = PdfSoundEncoding.Signed
soundAction.Sound.Rate = 44100# 设置播放参数
soundAction.Volume = 0.5
soundAction.Repeat = True
soundAction.Mix = True
soundAction.Synchronous = False# 在页面上绘制一张图片
image = PdfImage.FromFile("Sound.png")
page.Canvas.DrawImage(image, PointF(30.0, 30.0))# 使用声音动作创建PdfActionAnnotation实例
rect = RectangleF.FromLTRB(30.0, 30.0, image.GetBounds().Width + 30.0, image.GetBounds().Height + 30.0)
annotation = PdfActionAnnotation(rect, soundAction)# 将注释添加到页面
page.Annotations.Add(annotation)# 设置声音动作为文档打开后播放
# pdf.AfterOpenAction = soundAction# 保存文档
pdf.SaveToFile("output/PDF创建声音动作.pdf")
pdf.Close()

结果
Python PDF中创建声音动作

用Python在PDF中创建JavaScript动作

PdfJavaScriptAction类表示一个JavaScript动作，可在指定情况下在PDF文档中执行JavaScript代码，如填充表单、重置表单等。以下是在PDF中创建JavaScript动作的操作步骤示例：

导入所需模块。
创建PdfDocument类，并使用PdfDocument.LoadFromFile()方法载入PDF文件。
使用PdfDocument.Pages.get_Item()方法获取一个页面。
自定义一段JavaScript代码。
用此代码创建PdfJavaScriptAction实例。
用PdfJavaScriptAction实例在页面指定位置创建一个PdfActionAnnotation实例，并设置其颜色。
使用PdfPageBase.Annotations.Add()方法将注释添加到页面。
使用PdfDocument.SaveToFile()方法保存文档。
释放资源。

代码示例

from spire.pdf import *# 创建一个PdfDocument实例
pdf = PdfDocument()# 加载一个PDF文件
pdf.LoadFromFile("示例3.pdf")# 获取第一页
page = pdf.Pages.get_Item(0)# 指定JavaScript代码
js = """
var lastName = this.getField("LastName").value;
var firstName = this.getField("FirstName").value;
this.getField("FullName").value = lastName + " " + firstName;
"""# 创建一个JavaScript动作
jsAction = PdfJavaScriptAction(js)# 创建一个带有JavaScript动作的注释
rect = RectangleF.FromLTRB(380, 160, 460, 180)
annotation = PdfActionAnnotation(rect, jsAction)
annotation.Color = PdfRGBColor(Color.get_Red())# 将注释添加到页面上
page.Annotations.Add(annotation)# 绘制动作提示文本
font = PdfTrueTypeFont("宋体", 12.0, PdfFontStyle.Regular, True)
stringFormat = PdfStringFormat(PdfTextAlignment.Center)
text = "点击生成全名"
page.Canvas.DrawString(text, font, PdfBrushes.get_Red(), rect, stringFormat)# 保存文档
pdf.SaveToFile("output/PDF创建JavaScript动作.pdf")
pdf.Close()