Add TOC

O Documentize PDF Manager for .NET é um plugin poderoso projetado para melhorar a organização e a navegação de documentos PDF, gerando dinamicamente um Índice (TOC). Este plugin simplifica o processo de adicionar TOCs aos seus PDFs, tornando os documentos mais fáceis de navegar e gerenciar.

Como Gerar um TOC para um PDF

Para criar um Índice em um arquivo PDF, siga estas etapas:

  1. Crie uma instância de TocOptions para configurar as configurações de geração do TOC.
  2. Defina um Título usando a propriedade Title.
  3. Desenhe os Títulos do TOC usando o método Headings.Add.
  4. Adicione o arquivo PDF de entrada usando o método AddInput.
  5. Especifique o arquivo PDF de saída com o TOC usando o método AddOutput.
  6. Chame o método AddTableOfContents para gerar o TOC.
​
 1// Crie um objeto TocOptions para definir as instruções
 2var options = new TocOptions();
 3// Defina o Título
 4options.Title = "Meu Índice";
 5// Desenhe os Títulos
 6options.Headings.Add(new TocHeading("Introdução", 2));
 7options.Headings.Add(new TocHeading("Capítulo I", 3));
 8options.Headings.Add(new TocHeading("Capítulo II", 4));
 9options.Headings.Add(new TocHeading("Capítulo III", 5));
10// Adicione o caminho do arquivo de entrada
11options.AddInput(new FileDataSource("caminho_do_seu_arquivo_pdf.pdf"));
12// Defina o caminho do arquivo de saída
13options.AddOutput(new FileDataSource("caminho_do_arquivo_pdf_resultante.pdf"));
14// Realize o processo
15PdfManager.AddTableOfContents(options);

Gerar marcadores em um TOC para um PDF

Você pode usar a propriedade ‘GenerateBookmarks’ para a geração de marcadores.

​
 1// Crie um objeto TocOptions para definir as instruções
 2var options = new TocOptions();
 3// Defina o Título
 4options.Title = "Meu Índice";
 5// Gere links nos marcadores
 6options.GenerateBookmarks = true;
 7// Desenhe os Títulos
 8options.Headings.Add(new TocHeading("Introdução", 2, false, 1));
 9options.Headings.Add(new TocHeading("Capítulo I", 3, true, 1));
10options.Headings.Add(new TocHeading("Capítulo II", 4, true, 1));
11options.Headings.Add(new TocHeading("Exemplo A", 4, true, 2));
12options.Headings.Add(new TocHeading("Exemplo B", 4, true, 2));
13options.Headings.Add(new TocHeading("Exemplo C", 4, true, 2));
14options.Headings.Add(new TocHeading("Exemplo D", 4, true, 2));
15options.Headings.Add(new TocHeading("Capítulo III", 5, true, 1));
16// Adicione o caminho do arquivo de entrada
17options.AddInput(new FileDataSource("caminho_do_seu_arquivo_pdf.pdf"));
18// Defina o caminho do arquivo de saída
19options.AddOutput(new FileDataSource("caminho_do_arquivo_pdf_resultante.pdf"));
20// Realize o processo
21PdfManager.AddTableOfContents(options);

Como obter o Resultado como Stream

​
 1// Crie um objeto TocOptions para definir as instruções
 2var options = new TocOptions();
 3// Defina o Título
 4options.Title = "Meu Índice";
 5// Desenhe os Títulos
 6options.Headings.Add(new TocHeading("Introdução", 2, false, 1));
 7// Adicione o caminho do arquivo de entrada
 8options.AddInput(new FileDataSource("caminho_do_seu_arquivo_pdf.pdf"));
 9// Defina o stream de saída 
10var outputStream = new MemoryStream();
11options.AddOutput(new StreamDataSource(outputStream));
12options.CloseOutputStreams = false;
13// Realize o processo
14PdfManager.AddTableOfContents(options);

Personalizando o Título do TOC

Você pode personalizar o Título do Índice modificando a classe TocHeading. Por exemplo, você pode usar ‘GenerateNumbering’ ou fazê-lo manualmente. A propriedade ‘PageNumber’ é usada para links nas páginas. Você também pode usar a propriedade Level.

​
 1var heading = new TocHeading();
 2heading.Text = "Intro";
 3heading.PageNumber = 5;
 4heading.GenerateNumbering = true;
 5heading.Level = 2;
 6
 7var tocOptions = new TocOptions();
 8options.Headings.Add(heading);
 9// Adicione arquivos de entrada e saída
10tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
11tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
12
13// Gere o TOC com opções personalizadas
14PdfManager.AddTableOfContents(tocOptions);

Principais Recursos:

  • Geração Dinâmica de TOC: Crie um TOC para qualquer arquivo PDF com entradas geradas automaticamente com base em títulos ou marcadores.
  • Personalização: Controle a aparência e a estrutura do TOC, incluindo estilos, formatação e níveis de profundidade.
  • Fluxo de Trabalho Eficiente: Minimize o tempo gasto criando TOCs manualmente, especialmente para documentos grandes ou complexos.
 Português