PDF转换控件Aspose.PDF for .Net使用教程(十):添加和获取超链接
Aspose.PDF for .NET是一种高PDF处理和解析API,用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档,而无需使用Adobe Acrobat。此外,API还提供PDF压缩选项,表格创建和操作,图形和图像功能,广泛的超链接功能,印章和水印任务,扩展的安全控制和自定义字体处理。
在接下来的系列教程中,将为开发者带来Aspose.PDF for .NET的一系列使用教程,例如进行文档间的转换,如何标记PDF文件,如何使用表单和图表等等。
第三章:使用链接和操作
▲第二节:添加和获取超链接
在PDF文件中添加超链接
可以添加到PDF文件的超链接,以允许读者导航到PDF的另一部分或外部内容。为了向PDF文档添加Web超链接:
- 创建一个Document Class对象。
- 获取要添加链接的页面类。
- LinkAnnotation使用Page和Rectangle对象创建对象。矩形对象用于指定页面上应添加链接的位置。
- 将该Action属性设置为GoToURIAction指定远程URI位置的对象。
- 要显示超链接文本,请在与LinkAnnotation放置对象的位置类似的位置添加文本字符串。
- 添加自由文本
- 实例化一个FreeTextAnnotation对象。它还接受Page和Rectangle对象作为参数,因此可以提供与LinkAnnotation构造函数指定的相同的值。
- 使用FreeTextAnnotation对象的Contents属性,指定应在输出PDF中显示的字符串
- (可选)将两个LinkAnnotation和FreeTextAnnotation对象的边框宽度设置为0,以便它们不会出现在PDF文档中。
- 定义LinkAnnotation和FreeTextAnnotation对象后,将这些链接添加到Page对象的Annotations集合中。
- 使用Document对象的Save方法保存更新的PDF。
以下代码段显示如何向PDF文件添加超链接:
// 文档目录的路径。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打开文档 Document document = new Document(dataDir + "AddHyperlink.pdf"); //创建链接 Page page = document.Pages[1]; //创建链接注释对象 LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300)); //为LinkAnnotation创建边框对象 Border border = new Border(link); // 将边框宽度值设置为0 border.Width = 0; //设置LinkAnnotation的边框 link.Border = border; //将链接类型指定为远程URI link.Action = new GoToURIAction("www.aspose.com"); //将链接注释添加到PDF文件第一页的注释集合中 page.Annotations.Add(link); //创建自由文本注释 FreeTextAnnotation textAnnotation = new FreeTextAnnotation(document.Pages[1], new Aspose.Pdf.Rectangle(100, 100, 300, 300), new DefaultAppearance(Aspose.Pdf.Text.FontRepository.FindFont("TimesNewRoman"), 10, System.Drawing.Color.Blue)); //要添加为自由文本的字符串 textAnnotation.Contents = "Link to Aspose website"; //设置自由文本注释的边框 textAnnotation.Border = border; //将FreeText注释添加到Document第一页的注释集合中 document.Pages[1].Annotations.Add(textAnnotation); dataDir = dataDir + "AddHyperlink_out.pdf"; // 保存更新的文档 document.Save(dataDir);
创建相同PDF中页面的超链接
Aspose.PDF for .NET为PDF创建及其操作提供了很好的功能。它还提供了添加PDF页面链接的功能,链接可以指向另一个PDF文件中的页面,Web URL,启动应用程序的链接,甚至链接到同一PDF文件中的页面。为了添加本地超链接(指向同一PDF文件中的页面的链接),将一个名为LocalHyperlink的类添加到Aspose.PDF命名空间,并且此类具有名为TargetPageNumber的属性,该属性用于指定超链接的目标/目标页面。
为了添加本地超链接,需要创建一个TextFragment,以便链接可以与TextFragment相关联。该TextFragment类有一个属性命名超链接,用来LocalHyperlink实例相关联。以下代码段显示了完成此要求的步骤。
//文档目录的路径。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //创建文档实例 Document doc = new Document(); //将页面添加到PDF文件的页面集合中 Page page = doc.Pages.Add(); //创建文本片段实例 Aspose.Pdf.Text.TextFragment text = new Aspose.Pdf.Text.TextFragment("link page number test to page 7"); //创建本地超链接实例 Aspose.Pdf.LocalHyperlink link = new Aspose.Pdf.LocalHyperlink(); //设置链接实例的目标页面 link.TargetPageNumber = 7; //设置TextFragment超链接 text.Hyperlink = link; //将文本添加到Page的集合集合中 page.Paragraphs.Add(text); // 创建新的TextFragment实例 text = new TextFragment("link page number test to page 1"); // 应在新页面上添加TextFragment text.IsInNewPage = true; // 创建另一个本地超链接实例 link = new LocalHyperlink(); //为第二个超链接设置目标页面 link.TargetPageNumber = 1; // 设置第二个TextFragment的链接 text.Hyperlink = link; //将文本添加到页面对象的段落集合中 page.Paragraphs.Add(text); dataDir = dataDir + "CreateLocalHyperlink_out.pdf"; //保存更新的文档 doc.Save(dataDir);
从PDF文件中删除文档打开操作
链接在PDF文件中表示为注释,可以添加,更新或删除它们。Aspose.PDF for .NET还支持在PDF文件中获取超链接的目标(URL)。要获取链接的URL:
- 创建一个Document对象。
- 获取Page您想要从中提取链接。
- 使用AnnotationSelector该类LinkAnnotation从指定页面中提取所有对象。
- 将AnnotationSelector对象传递给Page对象的Accept()方法。
- IList使用AnnotationSelector对象的Selected属性将所有选定的链接注释添加到对象中。
- 提取LinkAnnotation Actionas GoToURIAction。
// The path to the documents directory. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); // Load the PDF file Document document = new Document(dataDir + "input.pdf"); // Traverse through all the page of PDF foreach (Aspose.Pdf.Page page in document.Pages) { // Get the link annotations from particular page AnnotationSelector selector = new AnnotationSelector(new Aspose.Pdf.Annotations.LinkAnnotation(page, Aspose.Pdf.Rectangle.Trivial)); page.Accept(selector); // Create list holding all the links IListlist = selector.Selected; // Iterate through invidiaul item inside list foreach (LinkAnnotation a in list) { // Print the destination URL Console.WriteLine("\nDestination: " + (a.Action as Aspose.Pdf.Annotations.GoToURIAction).URI + "\n"); }
获取超链接文本
超链接包含两部分:文档中显示的文本和目标URL。在某些情况下,它是文本而不是我们需要的URL。PDF文件中的文本和注释/操作由不同的实体表示。页面上的文本只是一组单词和字符,而注释带来了一些交互性,例如超链接中固有的交互性。
要查找URL内容,您需要使用注释和文本。该Annotation对象本身没有文本,但位于页面上的文本下。因此,要获取文本,请Annotation提供URL的边界,而Text对象则提供URL内容。请参阅以下代码段:
//文档目录的路径。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加载PDF文件 Document document = new Document(dataDir + "input.pdf"); // 遍历PDF的每一页 foreach (Page page in document.Pages) { //显示链接注释 ShowLinkAnnotations(page); }
如何在查看文档时指定PDF页面
在PDF查看器(如Adobe Reader)中查看PDF文件时,文件通常会在第一页上打开。但是,可以将文件设置为在其他页面上打开。
XYZExplicitDestination类允许你在要打开一个PDF文件中指定的页面。将GoToAction对象值传递给Document类OpenAction属性时,文档将在针对该XYZExplicitDestination对象指定的页面处打开。以下代码段显示如何将页面指定为文档打开操作。
//文档目录的路径 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加载PDF文件 Document doc = new Document(dataDir + "SpecifyPageWhenViewing.pdf"); //获取文档第二页的实例 Page page2 = doc.Pages[2]; // 创建变量以设置目标页面的缩放系数 double zoom = 1; //创建GoToAction实例 GoToAction action = new GoToAction(doc.Pages[2]); //转到2页 action.Destination = new XYZExplicitDestination(page2, 0, page2.Rect.Height, zoom); //设置文档打开操作 doc.OpenAction = action; //保存更新的文档 doc.Save(dataDir + "goto2page_out.pdf");
*想要购买Aspose.PDF for .NET正版授权的朋友可以了解详情哦~
欢迎加入ASPOSE技术交流QQ群,各类资源及时分享,技术问题交流讨论!(扫描下方二维码加入群聊)