Aspose.PDF for .NET使用教程(三):获取、更新和扩展书签

翻译|使用教程|编辑:李显亮|2019-07-12 10:45:32.840|阅读 71 次

概述:Aspose.PDF for .NET是一种高PDF处理和解析API,用于在跨平台应用程序中执行文档管理和操作任务。本文将讲述如何在Aspose.PDF中获取、更新和扩展书签。

相关链接:

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

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

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

第二章:使用书签

▲第二节:获取、更新和展开书签

从PDF文档中获取书签

Document对象的OutlineCollection集合包含PDF文件的所有书签。要获取书签,循环遍历OutlineCollection集合并获取OutlineItemCollection中的每个书签。OutlineItemCollection提供对所有书签属性的访问。下面的代码片段向您展示了如何从PDF文件中获取书签。

//指向documents目录的路径。
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

/ /打开文件
Document pdfDocument = new Document(dataDir + "GetBookmarks.pdf");

//循环遍历所有书签
foreach (OutlineItemCollection outlineItem in pdfDocument.Outlines)
{
    Console.WriteLine(outlineItem.Title);
    Console.WriteLine(outlineItem.Italic);
    Console.WriteLine(outlineItem.Bold);
    Console.WriteLine(outlineItem.Color);
}


获取书签的页码


一旦添加了书签,就可以通过获取与bookmark对象关联的目标PageNumber来查找它所在的页面。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

//创建PdfBookmarkEditor
PdfBookmarkEditor bookmarkEditor = new PdfBookmarkEditor();
//打开PDF文件
bookmarkEditor.BindPdf(dataDir + "GetBookmarks.pdf");
//提取书签
Aspose.Pdf.Facades.Bookmarks bookmarks = bookmarkEditor.ExtractBookmarks();
foreach (Aspose.Pdf.Facades.Bookmark bookmark in bookmarks)
{
    string strLevelSeprator = string.Empty;
    for (int i = 1; i < bookmark.Level; i++)
    {
        strLevelSeprator += "----";
    }

    Console.WriteLine("{0}Title: {1}", strLevelSeprator, bookmark.Title);
    Console.WriteLine("{0}Page Number: {1}", strLevelSeprator, bookmark.PageNumber);
    Console.WriteLine("{0}Page Action: {1}", strLevelSeprator, bookmark.Action);
}


从PDF文档中获取子书签


书签可以按照层次结构组织父级和子级。要获取所有书签,请循环遍历文档对象的大纲集合。但是,要同时获得子书签,还需要遍历第一个循环中获得的每个OutlineItemCollection对象中的所有书签。下面的代码片段展示了如何从PDF文档获取子书签。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

//打开文档
Document pdfDocument = new Document(dataDir + "GetChildBookmarks.pdf");

//遍历所有书签
foreach (OutlineItemCollection outlineItem in pdfDocument.Outlines)
{
    Console.WriteLine(outlineItem.Title);
    Console.WriteLine(outlineItem.Italic);
    Console.WriteLine(outlineItem.Bold);
    Console.WriteLine(outlineItem.Color);

    if (outlineItem.Count > 0)
    {
        Console.WriteLine("Child Bookmarks");
       //还有子书签循环通过它
        foreach (OutlineItemCollection childOutline in outlineItem)
        {
            Console.WriteLine(childOutline.Title);
            Console.WriteLine(childOutline.Italic);
            Console.WriteLine(childOutline.Bold);
            Console.WriteLine(childOutline.Color);
        }
    }
}

更新PDF文档中的书签


要更新PDF文件中的书签,首先通过指定书签的索引从Document对象的OutlineColletion集合中获取特定书签。将书签检索到OutlineItemCollection对象后,可以更新其属性,然后使用该Save方法保存更新的PDF文件。以下代码段显示如何更新PDF文档中的书签。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

//打开文档
Document pdfDocument = new Document(dataDir + "UpdateBookmarks.pdf");

//获取书签对象
OutlineItemCollection pdfOutline = pdfDocument.Outlines[1];
pdfOutline.Title = "Updated Outline";
pdfOutline.Italic = true;
pdfOutline.Bold = true;

dataDir = dataDir + "UpdateBookmarks_out.pdf";
//保存输出
pdfDocument.Save(dataDir);

编辑书签时继承缩放


单击书签(使用Aspose生成)时的默认缩放操作是适应页面宽度。不过,我们可以使用Acrobat编辑特定的书签操作,并将缩放设置为“继承缩放”。这样,无论用户当前如何查看文档,单击书签都不会改变他们的查看方式。”因此,需要在编辑书签时以编程方式继承zoom。

为了指定继承缩放,您应该使用0值,因为根据PDF规范,左边、顶部或缩放的任何参数都应该使用null值,或者缩放指定该参数的当前值应该保持不变。缩放值0与null值具有相同的含义。下面的代码片段展示了如何更新PDF文档中的书签。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

//打开文档
Document doc = new Document(dataDir + "input.pdf");

//获取PDF文件的大纲/书签集合
OutlineItemCollection item = new OutlineItemCollection(doc.Outlines);
//将缩放级别设置为0
XYZExplicitDestination dest = new XYZExplicitDestination(2, 100, 100, 0);
//添加XYZExplicitDestination作为动作以概述PDF的集合
item.Action = new GoToAction(dest);
//添加项目以概述PDF文件的集合
doc.Outlines.Add(item);

dataDir = dataDir + "InheritZoom_out.pdf";
//保存输出
doc.Save(dataDir);

查看文档时扩展书签


书签保存在Document对象的OutlineItemCollection集合中,本身在OutlineCollection集合中。但是,我们可能要求在查看PDF文件时扩展所有书签。

为了完成此要求,我们可以将每个大纲/书签项的打开状态设置为“打开”。以下代码段显示如何为PDF文档中展开的每个书签设置打开状态。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_AsposePdf_Bookmarks();

//打开文档
Document doc = new Document(dataDir + "input.pdf");

//设置页面查看模式,即显示缩略图,全屏,显示附件面板
doc.PageMode = PageMode.UseOutlines;
//遍历PDF文件的轮廓集合中的每个Ouline项目
foreach (OutlineItemCollection item in doc.Outlines)
{
    //设置大纲项目的打开状态
    item.Open = true;
}

dataDir = dataDir + "ExpandBookmarks_out.pdf";
//保存输出
doc.Save(dataDir);


-- 未完待续 --


*想要购买Aspose.PDF for .NET正版授权的朋友可以联系在线客服了解详情哦~

欢迎加入ASPOSE技术交流QQ群,各类资源及时分享,技术问题交流讨论!(扫描下方二维码加入群聊)

1560231367164.png


850X100.png




标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动成果

文章转载自:ASPOSE官方网站 https://docs.aspose.com/display/pdfnet/Get%2C+Update+and+Expand+a+Bookmark

登录慧都网发表评论登录


暂无评论...

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
相关厂商
相关产品
Aspose.PDF

PDF文档创建组件,无需Adobe Acrobat,也可以在任何平台上操作PDF文档。

在线客服 在线QQ 电话咨询
400-700-1020
反馈
在线客服系统
live chat