彩票走势图

PDF转换控件Aspose.PDF for .Net使用教程(十):添加和获取超链接

原创|使用教程|编辑:李显亮|2019-09-04 13:48:49.340|阅读 559 次

概述:在接下来的系列教程中,将为开发者带来Aspose.PDF for .NET的一系列使用教程,例如进行文档间的转换,如何标记PDF文件,如何使用表单和图表等等。本文介绍如何添加和获取超链接,希望对您有所帮助。

# 慧都年终大促·界面/图表报表/文档/IDE等千款热门软控件火热促销中 >>

相关链接:

Aspose.PDF for .NET是一种高PDF处理和解析API,用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档,而无需使用Adobe Acrobat。此外,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);
// 将边框宽度值设置为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:

  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 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群,各类资源及时分享,技术问题交流讨论!(扫描下方二维码加入群聊)

1560231367164.png


标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处、不得修改原文相关链接,如果存在内容上的异议请邮件反馈至chenjj@capbkgr.cn


为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
扫码咨询


添加微信 立即咨询

电话咨询

客服热线
023-68661681

TOP