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