PDF TOC Generator
Documentize PDF TOC Generator for .NET 是一个强大的插件,旨在通过动态生成目录 (TOC) 来增强 PDF 文档的组织和导航。这个插件简化了将 TOC 添加到 PDF 的过程,使文档更易于导航和管理。
如何为 PDF 生成 TOC
要在 PDF 文件中创建目录,请按照以下步骤操作:
- 创建一个
TocOptions
实例以配置 TOC 生成设置。 - 使用
Title
属性设置标题。 - 使用
Headings.Add
方法设计 TOC 的标题。 - 使用
AddInput
方法添加输入 PDF 文件。 - 使用
AddOutput
方法指定输出 PDF 文件及 TOC。 - 调用
Process
方法生成 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// 执行处理
15TocGenerator.Process(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// 执行处理
21TocGenerator.Process(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
14TocGenerator.Process(tocOptions);
如何获取结果流
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// 执行处理
14TocGenerator.Process(options);
主要特点:
- 动态 TOC 生成:为任何 PDF 文件创建 TOC,自动根据标题或书签生成条目。
- 批处理:一次为多个 PDF 文档生成 TOC。
- 定制:控制 TOC 的外观和结构,包括样式、格式和深度级别。
- 高效工作流程:最大限度减少手动创建 TOC 的时间,特别是对于大型或复杂文档。