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();

//创建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群，各类资源及时分享，技术问题交流讨论！（扫描下方二维码加入群聊）