PDF转换控件Aspose.PDF for .Net使用教程（十）：添加和获取超链接

Aspose.PDF for .NET是一种高PDF处理和解析API，用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档，而无需使用AdobeAcrobat。此外，API还提供PDF压缩选项，表格创建和操作，图形和图像功能，广泛的超链接功能，印章和水印任务，扩展的安全控制和自定义字体处理。

【下载体验Aspose.PDF for .NET最新版】

在接下来的系列教程中，将为开发者带来Aspose.PDF for .NET的一系列使用教程，例如进行文档间的转换，如何标记PDF文件，如何使用表单和图表等等。

第三章：使用链接和操作

▲第二节：添加和获取超链接

在PDF文件中添加超链接

可以添加到PDF文件的超链接，以允许读者导航到PDF的另一部分或外部内容。为了向PDF文档添加Web超链接：

1. 创建一个Document Class对象。
2. 获取要添加链接的页面类。
3. LinkAnnotation使用Page和Rectangle对象创建对象。矩形对象用于指定页面上应添加链接的位置。
4. 将该Action属性设置为GoToURIAction指定远程URI位置的对象。
5. 要显示超链接文本，请在与LinkAnnotation放置对象的位置类似的位置添加文本字符串。
6. 添加自由文本
1. 实例化一个FreeTextAnnotation对象。它还接受Page和Rectangle对象作为参数，因此可以提供与LinkAnnotation构造函数指定的相同的值。
2. 使用FreeTextAnnotation对象的Contents属性，指定应在输出PDF中显示的字符串
3. （可选）将两个LinkAnnotation和FreeTextAnnotation对象的边框宽度设置为0，以便它们不会出现在PDF文档中。
7. 定义LinkAnnotation和FreeTextAnnotation对象后，将这些链接添加到Page对象的Annotations集合中。
8. 使用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);// 将边框宽度值设置为0border.Width = 0;//设置LinkAnnotation的边框link.Border = border;//将链接类型指定为远程URIlink.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");// 应在新页面上添加TextFragmenttext.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：

1. 创建一个Document对象。
2. 获取Page您想要从中提取链接。
3. 使用AnnotationSelector该类LinkAnnotation从指定页面中提取所有对象。
4. 将AnnotationSelector对象传递给Page对象的Accept()方法。
5. IList使用AnnotationSelector对象的Selected属性将所有选定的链接注释添加到对象中。
6. 提取LinkAnnotation Actionas GoToURIAction。

// The path to the documents directory.string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions();// Load the PDF fileDocument document = new Document(dataDir + "input.pdf");// Traverse through all the page of PDFforeach (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群，各类资源及时分享，技术问题交流讨论！（扫描下方二维码加入群聊）

标签：