Add TOC

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

Как сгенерировать оглавление (TOC) для PDF

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

  1. Создайте экземпляр TocOptions для настройки параметров генерации TOC.
  2. Установите заголовок с помощью свойства Title.
  3. Определите пункты оглавления с помощью метода Headings.Add.
  4. Добавьте исходный PDF‑файл методом AddInput.
  5. Укажите целевой PDF‑файл с оглавлением методом AddOutput.
  6. Вызовите метод AddTableOfContents для генерации оглавления.
​
 1// Create TocOptions object to set instructions
 2var options = new TocOptions();
 3// Set the Title
 4options.Title = "My Table of Contents";
 5// Design Headings
 6options.Headings.Add(new TocHeading("Introduction", 2));
 7options.Headings.Add(new TocHeading("Chapter I", 3));
 8options.Headings.Add(new TocHeading("Chapter II", 4));
 9options.Headings.Add(new TocHeading("Chapter III", 5));
10// Add input file path
11options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
12// Set output file path
13options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
14// Perform the process
15PdfManager.AddTableOfContents(options);

Генерация закладок в оглавлении для PDF

Для создания закладок можно использовать свойство GenerateBookmarks.

​
 1// Create TocOptions object to set instructions
 2var options = new TocOptions();
 3// Set the Title
 4options.Title = "My Table of Contents";
 5// Generate links in bookmarks
 6options.GenerateBookmarks = true;
 7// Design Headings
 8options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
 9options.Headings.Add(new TocHeading("Chapter I", 3, true, 1));
10options.Headings.Add(new TocHeading("Chapter II", 4, true, 1));
11options.Headings.Add(new TocHeading("Example A", 4, true, 2));
12options.Headings.Add(new TocHeading("Example B", 4, true, 2));
13options.Headings.Add(new TocHeading("Example C", 4, true, 2));
14options.Headings.Add(new TocHeading("Example D", 4, true, 2));
15options.Headings.Add(new TocHeading("Chapter III", 5, true, 1));
16// Add input file path
17options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
18// Set output file path
19options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
20// Perform the process
21PdfManager.AddTableOfContents(options);

Как получить результат в виде потока

​
 1// Create TocOptions object to set instructions
 2var options = new TocOptions();
 3// Set the Title
 4options.Title = "My Table of Contents";
 5// Design Headings
 6options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
 7// Add input file path
 8options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
 9// Set output stream 
10var outputStream = new MemoryStream();
11options.AddOutput(new StreamData(outputStream));
12options.CloseOutputStreams = false;
13// Perform the process
14PdfManager.AddTableOfContents(options);

Настройка заголовка оглавления (TOC Heading)

Вы можете кастомизировать заголовок оглавления, изменяя класс TocHeading. Например, можно использовать свойство GenerateNumbering или задать нумерацию вручную. Свойство PageNumber используется для ссылок на страницы. Также доступно свойство Level.

​
 1// Create TocOptions object to set instructions
 2var heading = new TocHeading();
 3heading.Text = "Intro";
 4heading.PageNumber = 5;
 5heading.GenerateNumbering = true;
 6heading.Level = 2;
 7var tocOptions = new TocOptions();
 8options.Headings.Add(heading);
 9// Add input and output files
10tocOptions.AddInput(new FileData("path_to_your_pdf_file.pdf"));
11tocOptions.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
12// Generate the TOC with customized options
13PdfManager.AddTableOfContents(tocOptions);

Ключевые особенности:

  • Динамическое создание TOC: создавайте оглавление для любого PDF‑файла с автоматически сформированными записями на основе заголовков или закладок.
  • Настройка: управляйте внешним видом и структурой оглавления, включая стили, форматирование и уровни вложенности.
  • Эффективный рабочий процесс: сокращайте время, затрачиваемое на ручное создание оглавлений, особенно для больших или сложных документов.
 Русский