PDF转换控件Aspose.PDF for .Net使用教程(九):在PDF文件中创建、更新和提取链接
Aspose.PDF for .NET是一种高PDF处理和解析API,用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档,而无需使用Adobe Acrobat。此外,API还提供PDF压缩选项,表格创建和操作,图形和图像功能,广泛的超链接功能,印章和水印任务,扩展的安全控制和自定义字体处理。
在接下来的系列教程中,将为开发者带来Aspose.PDF for .NET的一系列使用教程,例如进行文档间的转换,如何标记PDF文件,如何使用表单和图表等等。
第三章:使用链接和操作
▲第一节:创建、更新和提取链接
在PDF文件中创建应用程序链接
通过将应用程序的链接添加到文档中,可以链接到文档中的应用程序。例如,读者在教程中的特定点执行某个操作或创建功能丰富的文档时,这功能非常有用。要创建应用程序链接:
- 创建一个Document对象。
- 获取Page要添加链接的链接。
- LinkAnnotation使用Page和Rectangle对象创建对象。
- 使用LinkAnnotation对象设置链接属性。
- 设置LaunchAction对象的Action属性。
- 创建LaunchAction对象时,请指定要启动的应用程序。
- 将链接添加到Page对象的Annotations属性。
- 使用Document对象的Save方法保存更新的PDF。
以下代码段显示了如何在PDF文件中创建指向应用程序的链接:
//文档目录的路径。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打开文档 Document document = new Document( dataDir + "CreateApplicationLink.pdf"); //创建链接 Page page = document.Pages[1]; LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300)); link.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green); link.Action = new LaunchAction(document, dataDir + "CreateApplicationLink.pdf"); page.Annotations.Add(link); dataDir = dataDir + "CreateApplicationLink_out.pdf"; //保存更新的文档 document.Save(dataDir);
在PDF文件中创建PDF文档链接
Aspose.PDF for .NET允许添加指向外部PDF文件的链接,以便可以将多个文档链接在一起。要创建PDF文档链接:
- 创建一个Document对象。
- 获取Page要添加链接的特定内容。
- LinkAnnotation使用Page和Rectangle对象创建对象。
- 使用LinkAnnotation对象设置链接属性。
- 将Action属性设置为GoToRemoteAction对象。
- 创建GoToRemoteAction对象时,请指定应启动的PDF文件以及应打开的页码。
- 将链接添加到Page对象的Annotations集合中。
- 使用Document对象的Save方法保存更新的PDF。
以下代码段显示了如何在PDF文件中创建PDF文档链接:
// 文档目录的路径 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打开文档 Document document = new Document(dataDir+ "CreateDocumentLink.pdf"); //创建链接 Page page = document.Pages[1]; LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300)); link.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green); link.Action = new GoToRemoteAction(dataDir + "RemoveOpenAction.pdf", 1); page.Annotations.Add(link); dataDir = dataDir + "CreateDocumentLink_out.pdf"; //保存更新的文档 document.Save(dataDir);
更新PDF文件中的链接
如在PDF文件中添加超链接中所述,LinkAnnotation该类可以在PDF文件中添加链接。还有一个类似的类用于从PDF文件内部获取现有链接。如果需要更新现有链接,请使用此选项。要更新现有链接:
- 加载PDF文件。
- 转到PDF文件中的特定页面。
- 使用GoToAction对象的Destination属性指定链接目标。
- 使用XYZExplicitDestination构造函数指定目标页面。
将链接目标设置为同一文档中的页面
以下代码段显示如何更新PDF文件中的链接并将其目标设置为文档的第二页:
// 文档目录的路径. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加载PDF文件 Document doc = new Document(dataDir + "UpdateLinks.pdf"); // 从文档的第一页获取第一个链接注释 LinkAnnotation linkAnnot = (LinkAnnotation)doc.Pages[1].Annotations[1]; // 修改链接:更改链接目标 GoToAction goToAction = (GoToAction)linkAnnot.Action; //指定链接对象的目标 // 第一个参数是文档对象,第二个是目标页码。 // 显示相应页面时,5ht参数是缩放系数。使用2时,页面将以200%缩放显示 goToAction.Destination = new Aspose.Pdf.Annotations.XYZExplicitDestination(1, 1, 2, 2); dataDir = dataDir + "PDFLINK_Modified_UpdateLinks_out.pdf"; //使用更新的链接保存文档 doc.Save(dataDir);
将链接目标设置为Web地址
要更新超链接以使其指向Web地址,请实例化GoToURIAction对象并将其传递给LinkAnnotations Action属性。以下代码段显示了如何更新PDF文件中的链接并将其目标设置为Web地址。
//文档目录的路径。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加载PDF文件 Document doc = new Document(dataDir + "UpdateLinks.pdf"); //从文档的第一页获取第一个链接注释 LinkAnnotation linkAnnot = (LinkAnnotation)doc.Pages[1].Annotations[1]; //修改链接:更改链接操作并将目标设置为Web地址 linkAnnot.Action = new GoToURIAction("www.aspose.com"); dataDir = dataDir + "SetDestinationLink_out.pdf"; //使用更新的链接保存文档 doc.Save(dataDir);
将链接目标设置为另一个PDF文件
以下代码段显示如何更新PDF文件中的链接并将其目标设置为另一个PDF文件。
//文档目录的路径 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加载PDF文件 Document document = new Document(dataDir + "UpdateLinks.pdf"); LinkAnnotation linkAnnot = (LinkAnnotation)document.Pages[1].Annotations[1]; GoToRemoteAction goToR = (GoToRemoteAction)linkAnnot.Action; //下一行更新目标,不要更新文件 goToR.Destination = new XYZExplicitDestination(2, 0, 0, 1.5); //下一行更新文件 goToR.File = new FileSpecification(dataDir + "input.pdf"); dataDir = dataDir + "SetTargetLink_out.pdf"; //使用更新的链接保存文档 document.Save(dataDir);
更新LinkAnnotation文本颜色
链接注释不包含文本,而是将文本放在注释下的页面内容中。因此,要更改文本的颜色,请替换页面文本的颜色,而不是尝试更改注释的颜色。以下代码段显示了如何更新PDF文件中链接批注的颜色。
// 文档目录的路径. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加载PDF文件 Document doc = new Document(dataDir + "UpdateLinks.pdf"); foreach (Annotation annotation in doc.Pages[1].Annotations) { if (annotation is LinkAnnotation) { //搜索注释下的文本 TextFragmentAbsorber ta = new TextFragmentAbsorber(); Rectangle rect = annotation.Rect; rect.LLX -= 10; rect.LLY -= 10; rect.URX += 10; rect.URY += 10; ta.TextSearchOptions = new TextSearchOptions(rect); ta.Visit(doc.Pages[1]); //更改文本的颜色. foreach (TextFragment tf in ta.TextFragments) { tf.TextState.ForegroundColor = Color.Red; } } } dataDir = dataDir + "UpdateLinkTextColor_out.pdf"; //使用更新的链接保存文档 doc.Save(dataDir);
从PDF文件中提取链接
链接在PDF文件中表示为注释,因此要提取链接,请提取所有LinkAnnotation对象:
- 创建一个Document对象。
- 获取要从中提取链接的页面。
- 使用AnnotationSelector类从指定页面中提取所有LinkAnnotation对象。
- 将AnnotationSelector对象传递给Page对象的Accept方法。
- 使用AnnotationSelector对象的Selected属性将所有选定的链接注释添加到IList对象中。
以下代码段显示了如何从PDF文件中提取链接:
//文档目录的路径. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打开文档 Document document = new Document(dataDir+ "ExtractLinks.pdf"); //提取动作 Page page = document.Pages[1]; AnnotationSelector selector = new AnnotationSelector(new LinkAnnotation(page, Aspose.Pdf.Rectangle.Trivial)); page.Accept(selector); IListlist = selector.Selected; Annotation annotation = (Annotation)list[0]; dataDir = dataDir + "ExtractLinks_out.pdf"; //保存更新的文档 document.Save(dataDir);
*想要购买Aspose.PDF for .NET正版授权的朋友可以了解详情哦~
欢迎加入ASPOSE技术交流QQ群,各类资源及时分享,技术问题交流讨论!(扫描下方二维码加入群聊)