Aspose.PDF for .NET使用教程（三）：获取、更新和扩展书签

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();//创建PdfBookmarkEditorPdfBookmarkEditor 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);

为了指定继承缩放，您应该使用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);//将缩放级别设置为0XYZExplicitDestination 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群，各类资源及时分享，技术问题交流讨论！（扫描下方二维码加入群聊）

标签：