PDF TOC Generator
O Documentize PDF TOC Generator for .NET é um poderoso plugin projetado para aprimorar a organização e a navegação de documentos PDF, gerando dinamicamente uma Tabela de Conteúdos (TOC). Este plugin simplifica o processo de adição de TOCs aos seus PDFs, facilitando a navegação e o gerenciamento dos documentos.
Como Gerar uma TOC para um PDF
Para criar uma Tabela de Conteúdos em um arquivo PDF, siga estes passos:
- Crie uma instância de
TocOptions
para configurar as configurações de geração do TOC. - Defina um Título usando a propriedade
Title
. - Desenhe os Títulos do TOC usando o método
Headings.Add
. - Adicione o arquivo PDF de entrada usando o método
AddInput
. - Especifique o arquivo PDF de saída com o TOC usando o método
AddOutput
. - Chame o método
Process
para gerar o TOC.
1// Crie um objeto TocOptions para definir instruções
2var options = new TocOptions();
3// Defina o Título
4options.Title = "Minha Tabela de Conteúdos";
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_para_seu_arquivo_pdf.pdf"));
12// Defina o caminho do arquivo de saída
13options.AddOutput(new FileDataSource("caminho_para_arquivo_pdf_resultado.pdf"));
14// Realize o processo
15TocGenerator.Process(options);
Gerar marcadores em um TOC para um PDF
Você pode usar a propriedade ‘GenerateBookmarks’ para geração de marcadores.
1// Crie um objeto TocOptions para definir instruções
2var options = new TocOptions();
3// Defina o Título
4options.Title = "Minha Tabela de Conteúdos";
5// Gere links em 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_para_seu_arquivo_pdf.pdf"));
18// Defina o caminho do arquivo de saída
19options.AddOutput(new FileDataSource("caminho_para_arquivo_pdf_resultado.pdf"));
20// Realize o processo
21TocGenerator.Process(options);
Personalizando o Título do TOC
Você pode personalizar o Título da Tabela de Conteúdos modificando a classe TocHeading
. Por exemplo, você pode usar ‘GenerateNumbering’ ou fazer isso manualmente.
A propriedade ‘PageNumber’ é usada para links nas páginas. Também é possível 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
14TocGenerator.Process(tocOptions);
Como obter o Resultado como Stream
1// Crie um objeto TocOptions para definir instruções
2var options = new TocOptions();
3// Defina o Título
4options.Title = "Minha Tabela de Conteúdos";
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_para_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
14TocGenerator.Process(options);
Principais Funcionalidades:
- Geração Dinâmica de TOC: Crie um TOC para qualquer arquivo PDF com entradas geradas automaticamente com base em títulos ou marcadores.
- Processamento em Lote: Gere TOCs para vários documentos PDF ao mesmo tempo.
- 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 longos ou complexos.