Add TOC

Documentize PDF Manager for .NET 是一个强大的插件，旨在通过动态生成目录 (TOC) 来增强 PDF 文档的组织和导航。此插件简化了将 TOC 添加到 PDF 的过程，使文档更易于导航和管理。

如何为 PDF 生成 TOC

要在 PDF 文件中创建目录，按照以下步骤操作：

  1. 创建一个 TocOptions 实例以配置 TOC 生成设置。
  2. 使用 Title 属性设置标题。
  3. 使用 Headings.Add 方法设计 TOC 的标题。
  4. 使用 AddInput 方法添加输入 PDF 文件。
  5. 使用 AddOutput 方法指定带有 TOC 的输出 PDF 文件。
  6. 调用 AddTableOfContents 方法生成 TOC。
​
 1// 创建 TocOptions 对象以设置指令
 2var options = new TocOptions();
 3// 设置标题
 4options.Title = "我的目录";
 5// 设计标题
 6options.Headings.Add(new TocHeading("引言", 2));
 7options.Headings.Add(new TocHeading("第一章", 3));
 8options.Headings.Add(new TocHeading("第二章", 4));
 9options.Headings.Add(new TocHeading("第三章", 5));
10// 添加输入文件路径
11options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
12// 设置输出文件路径
13options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
14// 执行该过程
15PdfManager.AddTableOfContents(options);

在 PDF 的 TOC 中生成书签

您可以使用 ‘GenerateBookmarks’ 属性来生成书签。

​
 1// 创建 TocOptions 对象以设置指令
 2var options = new TocOptions();
 3// 设置标题
 4options.Title = "我的目录";
 5// 在书签中生成链接
 6options.GenerateBookmarks = true;
 7// 设计标题
 8options.Headings.Add(new TocHeading("引言", 2, false, 1));
 9options.Headings.Add(new TocHeading("第一章", 3, true, 1));
10options.Headings.Add(new TocHeading("第二章", 4, true, 1));
11options.Headings.Add(new TocHeading("示例 A", 4, true, 2));
12options.Headings.Add(new TocHeading("示例 B", 4, true, 2));
13options.Headings.Add(new TocHeading("示例 C", 4, true, 2));
14options.Headings.Add(new TocHeading("示例 D", 4, true, 2));
15options.Headings.Add(new TocHeading("第三章", 5, true, 1));
16// 添加输入文件路径
17options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
18// 设置输出文件路径
19options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
20// 执行该过程
21PdfManager.AddTableOfContents(options);

如何将结果作为流获取

​
 1// 创建 TocOptions 对象以设置指令
 2var options = new TocOptions();
 3// 设置标题
 4options.Title = "我的目录";
 5// 设计标题
 6options.Headings.Add(new TocHeading("引言", 2, false, 1));
 7// 添加输入文件路径
 8options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
 9// 设置输出流 
10var outputStream = new MemoryStream();
11options.AddOutput(new StreamDataSource(outputStream));
12options.CloseOutputStreams = false;
13// 执行该过程
14PdfManager.AddTableOfContents(options);

自定义 TOC 标题

您可以通过修改 TocHeading 类自定义目录标题。例如，您可以使用 ‘GenerateNumbering’ 或手动完成。 用于页面链接的属性 ‘PageNumber’。您还可以使用 Level 属性。

​
 1var heading = new TocHeading();
 2heading.Text = "引言";
 3heading.PageNumber = 5;
 4heading.GenerateNumbering = true;
 5heading.Level = 2;
 6
 7var tocOptions = new TocOptions();
 8options.Headings.Add(heading);
 9// 添加输入和输出文件
10tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
11tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
12
13// 使用自定义选项生成 TOC
14PdfManager.AddTableOfContents(tocOptions);

关键特性：

  • 动态 TOC 生成：为任何 PDF 文件创建目录，自动根据标题或书签生成条目。
  • 自定义：控制 TOC 的外观和结构，包括样式、格式和深度级别。
  • 高效工作流程：减少手动创建 TOC 的时间，尤其适用于大型或复杂文档。
 中文