Add TOC

Documentize PDF Manager for .NET - это мощный плагин, предназначенный для улучшения организации и навигации PDF-документов за счет динамического создания оглавления (TOC). Этот плагин упрощает процесс добавления оглавлений в ваши PDF-файлы, что делает документы более удобными для навигации и управления.

Как создать оглавление для PDF

Чтобы создать оглавление в файле PDF, выполните следующие шаги:

  1. Создайте экземпляр TocOptions для настройки параметров генерации TOC.
  2. Установите заголовок, используя свойство Title.
  3. Создайте заголовки TOC с помощью метода Headings.Add.
  4. Добавьте входной PDF-файл, используя метод AddInput.
  5. Укажите выходной PDF-файл с TOC, используя метод AddOutput.
  6. Вызовите метод AddTableOfContents для генерации TOC.
​
 1// Создайте объект TocOptions для установки инструкций
 2var options = new TocOptions();
 3// Установите заголовок
 4options.Title = "My Table of Contents";
 5// Создайте заголовки
 6options.Headings.Add(new TocHeading("Введение", 2));
 7options.Headings.Add(new TocHeading("Глава I", 3));
 8options.Headings.Add(new TocHeading("Глава II", 4));
 9options.Headings.Add(new TocHeading("Глава III", 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

Вы можете использовать свойство ‘GenerateBookmarks’ для генерации закладок.

​
 1// Создайте объект TocOptions для установки инструкций
 2var options = new TocOptions();
 3// Установите заголовок
 4options.Title = "My Table of Contents";
 5// Генерировать ссылки в закладках
 6options.GenerateBookmarks = true;
 7// Создайте заголовки
 8options.Headings.Add(new TocHeading("Введение", 2, false, 1));
 9options.Headings.Add(new TocHeading("Глава I", 3, true, 1));
10options.Headings.Add(new TocHeading("Глава II", 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("Глава III", 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 = "My Table of Contents";
 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: Создавайте TOC для любых PDF-файлов с автоматически сгенерированными записями на основе заголовков или закладок.
  • Кастомизация: Контролируйте внешний вид и структуру TOC, включая стили, форматирование и уровни глубины.
  • Эффективный рабочий процесс: Минимизируйте время, затрачиваемое на ручное создание TOC, особенно для больших или сложных документов.
 Русский