增强 pdf 文档的交互性对于优化文档管理和改善用户体验至关重要。通过在 .net 框架中使用 c# 创建 pdf 动作，开发者可以为 pdf 文档添加各种动态元素，比如文件链接、导航按钮、网页链接以及音频等。这些元素不仅能够实现诸如跳转至特定页面、打开目标网站、访问相关文件或播放音乐等功能，还能显著提高文档的实用性与用户满意度。本文将介绍如何使用 spire.pdf for .net 库，通过 c# 在 pdf 文档中创建动作。
- 用 c# 向 pdf 添加动作的基本操作步骤
- 用 c# 在 pdf 中创建导航动作
- 用 c# 在 pdf 中创建文件打开动作
- 用 c# 在 pdf 中创建音频动作
- 用 c# 在 pdf 中创建网页链接动作
- 用 c# 在 pdf 中创建 javascript 动作
安装 spire.pdf for .net
首先，您需要添加 spire.pdf for .net 包中包含的 dll 文件作为 .net 项目中的引用。dll 文件可以从此链接下载或通过 安装。
pm> install-package spire.pdf用 c# 向 pdf 添加动作的操作步骤
通过 c# 向 pdf 添加动作可集成多种交互元素，从而增强用户体验，例如导航按钮、文件链接或音效触发器。借助 spire.pdf for .net 库，开发者可以利用关键类和方法创建各种动作。以下是使用 spire.pdf for .net 添加 pdf 动作的一般流程：
- 创建 pdfdocument 类的实例，并通过 pdfdocument.loadfromfile() 方法加载 pdf 文档。
- 使用 pdfdocument.pages[] 属性获取页面。
- 创建表示动作的类的实例，并设置其属性。
- 使用动作在页面的矩形区域内创建 pdfactionannotation 类的实例。
- 为动作添加提示文字（可选）。
- 使用 pdfpagebase.annotations.add() 方法将动作注释添加到页面。
- 使用 pdfdocument.savetofile() 方法保存生成的文档。
用 c# 在 pdf 中创建导航动作
通过 pdfgotoaction 类可以创建导航动作，允许在文档内导航到指定目标位置。为实现这一功能，开发者可以创建一个 pdfdestination 对象，并将其作为参数传递给 pdfgotoaction 实例，然后将其添加到 pdf 文档中。以下是在 pdf 中添加导航动作的代码示例：
- c#
using spire.pdf;
using spire.pdf.actions;
using spire.pdf.annotations;
using spire.pdf.general;
using spire.pdf.graphics;
using system.drawing;
namespace addnavigationbuttonpdf
{
class program
{
static void main(string[] args)
{
// 创建 pdfdocument 的实例
pdfdocument pdf = new pdfdocument();
// 加载 pdf 文件
pdf.loadfromfile("示例.pdf");
// 创建 pdfdestination 实例并设置目标位置
pdfdestination destination = new pdfdestination(pdf.pages[1]);
destination.location = new pointf(0, 0);
destination.mode = pdfdestinationmode.location;
destination.zoom = 0.8f;
// 基于目标位置创建 pdfgotoaction 实例
pdfgotoaction action = new pdfgotoaction(destination);
// 创建矩形并绘制到第一页
rectanglef rect = new rectanglef(70, pdf.pagesettings.size.height - 120, 140, 20);
pdf.pages[0].canvas.drawrectangle(pdfbrushes.lightgray, rect);
// 在矩形中绘制文本
pdftruetypefont font = new pdftruetypefont(new font("harmonyos sans sc", 14f, fontstyle.bold), true);
pdfstringformat stringformat = new pdfstringformat(pdftextalignment.center);
pdf.pages[0].canvas.drawstring("跳转到第2页", font, pdfbrushes.green, rect, stringformat);
// 基于矩形和动作创建 pdfactionannotation 实例
pdfactionannotation actionannotation = new pdfactionannotation(rect, action);
// 将动作注释添加到第一页
pdf.pages[0].annotations.add(actionannotation);
// 保存文档
pdf.savetofile("output/导航动作.pdf");
pdf.close();
}
}
}
用 c# 在 pdf 中创建文件打开动作
pdflaunchaction 类用于创建 pdf 中的文件打开动作，允许用户通过点击 pdf 页面上的按钮等方式时打开指定文件。在实现此动作时，开发者可以设置文件路径（绝对路径或相对路径），并决定文件是否在新窗口中打开。以下是为 pdf 文档添加文件打开动作的代码示例：
- c#
using spire.pdf;
using spire.pdf.actions;
using spire.pdf.annotations;
using spire.pdf.graphics;
using system.drawing;
namespace addfilelaunchactionpdf
{
class program
{
static void main(string[] args)
{
// 创建 pdfdocument 的实例
pdfdocument pdf = new pdfdocument();
// 加载 pdf 文件
pdf.loadfromfile("示例.pdf");
// 获取第一页
pdfpagebase page = pdf.pages[0];
// 在页面上绘制矩形
rectanglef rect = new rectanglef(50, 50, 180, 20);
page.canvas.drawrectangle(pdfbrushes.lightgray, rect);
// 在矩形内绘制文本
pdftruetypefont font = new pdftruetypefont(new font("harmonyos sans sc", 14f, fontstyle.bold), true);
pdfstringformat stringformat = new pdfstringformat(pdftextalignment.center);
pdf.pages[0].canvas.drawstring("点击打开 示例2.pdf", font, pdfbrushes.green, rect, stringformat);
// 创建 pdflaunchaction 实例
pdflaunchaction action = new pdflaunchaction("c:/示例2.pdf", pdffilepathtype.absolute);
// 设置启动模式为在新窗口中打开
action.isnewwindow = true;
// 基于矩形和启动动作创建 pdfactionannotation 实例
pdfactionannotation actionannotation = new pdfactionannotation(rect, action);
// 将动作注释添加到第一页
page.annotations.add(actionannotation);
// 保存文档
pdf.savetofile("output/文件打开动作.pdf");
pdf.close();
}
}
}
用 c# 在 pdf 中创建音频动作
开发者可以通过 pdfsoundaction 类将音频嵌入到 pdf 文档中，使音频在响应特定触发事件时播放，例如打开文件或点击按钮。以下是在 pdf 文档中创建音效动作的代码示例：
- c#
using spire.pdf;
using spire.pdf.actions;
using spire.pdf.annotations;
using spire.pdf.graphics;
using spire.pdf.general;
using system.drawing;
namespace addsoundactionpdf
{
class program
{
static void main(string[] args)
{
// 创建 pdfdocument 的实例
pdfdocument pdf = new pdfdocument();
// 加载 pdf 文件
pdf.loadfromfile("示例.pdf");
// 获取第一页
pdfpagebase page = pdf.pages[0];
// 在页面上绘制提示图像
pdfimage image = pdfimage.fromfile("sound.png");
page.canvas.drawimage(image, new pointf(30, 30));
// 创建 pdfsoundaction 实例并设置其属性
pdfsoundaction action = new pdfsoundaction("wave.wav");
// 设置声音参数
action.sound.bits = 16;
action.sound.channels = pdfsoundchannels.stereo;
action.sound.encoding = pdfsoundencoding.signed;
action.sound.rate = 44100;
// 设置播放选项
action.volume = 0;
action.repeat = true;
action.mix = true;
action.synchronous = true;
// 基于提示图像的位置创建 pdfactionannotation 实例，用于声音动作
rectanglef rect = new rectanglef(30, 30, image.width, image.height);
pdfactionannotation actionannotation = new pdfactionannotation(rect, action);
// 将动作注释添加到第一页
page.annotations.add(actionannotation);
// 设置在文档打开后播放声音动作
pdf.afteropenaction = action;
// 保存文档
pdf.savetofile("output/声音动作.pdf");
pdf.close();
}
}
}
用 c# 在 pdf 中创建网页链接动作
开发者可以使用 pdfuriaction 类在 pdf 文档中创建网页链接动作，允许用户在执行特定操作（如点击按钮）时打开一个网页链接。以下是在 pdf 文档中创建网页链接动作的代码示例：
- c#
using spire.pdf;
using spire.pdf.actions;
using spire.pdf.annotations;
using spire.pdf.graphics;
using system.drawing;
namespace addsoundactionpdf
{
class program
{
static void main(string[] args)
{
// 创建 pdfdocument 的实例
pdfdocument pdf = new pdfdocument();
// 加载 pdf 文件
pdf.loadfromfile("示例.pdf");
// 获取第一页
pdfpagebase page = pdf.pages[0];
// 在页面上绘制矩形
rectanglef rect = new rectanglef(30, 30, 120, 20);
page.canvas.drawrectangle(pdfbrushes.lightgray, rect);
// 在矩形内绘制文本
pdftruetypefont font = new pdftruetypefont(new font("harmonyos sans sc", 14f, fontstyle.bold), true);
pdfstringformat stringformat = new pdfstringformat(pdftextalignment.center);
page.canvas.drawstring("点击跳转至百度搜索", font, pdfbrushes.lightskyblue, rect);
// 创建 pdfuriaction 实例并设置其属性
pdfuriaction action = new pdfuriaction();
action.uri = "https://www.baidu.com/";
// 使用网页链接动作和矩形创建 pdfactionannotation 实例
pdfactionannotation actionannotation = new pdfactionannotation(rect, action);
// 将动作注释添加到第一页
page.annotations.add(actionannotation);
// 保存文档
pdf.savetofile("output/网页链接动作.pdf");
pdf.close();
}
}
}
用 c# 在 pdf 中创建 javascript 动作
pdfjavascriptaction 代表 pdf 中的 javascript 动作，它可以帮助开发人员创建复杂的交互，如表单验证、数据计算和自定义用户界面。下面是用 c# 在 pdf 文档中添加简单的 javascript 动作的代码示例：
- c#
using spire.pdf;
using spire.pdf.actions;
namespace addjavascriptactionpdf
{
class program
{
static void main(string[] args)
{
// 创建pdfdocument实例
pdfdocument pdf = new pdfdocument();
// 载入pdf文件
pdf.loadfromfile("示例.pdf");
// 定义javascript代码
var jscode =
"app.alert({"
" cmsg: '欢迎阅读《火星：太阳系中的红色行星》。\\n\\n本文将详细介绍火星的基本信息、探索历史及其重要里程碑。', "
" nicon: 3, "
" ctitle: '文档介绍'"
"});";
// 使用javascript代码作为参数创建pdfjavascriptaction实例
pdfjavascriptaction action = new pdfjavascriptaction(jscode);
// 将创建的javascript动作设置为文档打开时执行
pdf.afteropenaction = action;
// 保存文档
pdf.savetofile("output/pdfjavascript动作.pdf");
pdf.close();
}
}
}
申请临时 license
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。
