Add TOC

El Documentize PDF Manager para .NET es un potente complemento diseñado para mejorar la organización y navegación de documentos PDF generando dinámicamente una Tabla de Contenidos (TOC). Este complemento simplifica el proceso de agregar TOCs a tus PDFs, haciendo que los documentos sean más fáciles de navegar y gestionar.

Cómo Generar un TOC para un PDF

Para crear una Tabla de Contenidos en un archivo PDF, sigue estos pasos:

  1. Crea una instancia de TocOptions para configurar los ajustes de generación del TOC.
  2. Establece un Título usando la propiedad Title.
  3. Diseña los Encabezados del TOC utilizando el método Headings.Add.
  4. Añade el archivo PDF de entrada usando el método AddInput.
  5. Especifica el archivo PDF de salida con el TOC usando el método AddOutput.
  6. Llama al método AddTableOfContents para generar el TOC.
​
 1// Crear objeto TocOptions para establecer instrucciones
 2var options = new TocOptions();
 3// Establecer el Título
 4options.Title = "Mi Tabla de Contenidos";
 5// Diseñar Encabezados
 6options.Headings.Add(new TocHeading("Introducción", 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// Agregar ruta del archivo de entrada
11options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
12// Establecer ruta del archivo de salida
13options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
14// Realizar el proceso
15PdfManager.AddTableOfContents(options);

Generar marcadores en un TOC para un PDF

Puedes usar la propiedad ‘GenerateBookmarks’ para la generación de marcadores.

​
 1// Crear objeto TocOptions para establecer instrucciones
 2var options = new TocOptions();
 3// Establecer el Título
 4options.Title = "Mi Tabla de Contenidos";
 5// Generar enlaces en marcadores
 6options.GenerateBookmarks = true;
 7// Diseñar Encabezados
 8options.Headings.Add(new TocHeading("Introducción", 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("Ejemplo A", 4, true, 2));
12options.Headings.Add(new TocHeading("Ejemplo B", 4, true, 2));
13options.Headings.Add(new TocHeading("Ejemplo C", 4, true, 2));
14options.Headings.Add(new TocHeading("Ejemplo D", 4, true, 2));
15options.Headings.Add(new TocHeading("Capítulo III", 5, true, 1));
16// Agregar ruta del archivo de entrada
17options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
18// Establecer ruta del archivo de salida
19options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
20// Realizar el proceso
21PdfManager.AddTableOfContents(options);

Cómo obtener el Resultado como Stream

​
 1// Crear objeto TocOptions para establecer instrucciones
 2var options = new TocOptions();
 3// Establecer el Título
 4options.Title = "Mi Tabla de Contenidos";
 5// Diseñar Encabezados
 6options.Headings.Add(new TocHeading("Introducción", 2, false, 1));
 7// Agregar ruta del archivo de entrada
 8options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
 9// Establecer stream de salida 
10var outputStream = new MemoryStream();
11options.AddOutput(new StreamDataSource(outputStream));
12options.CloseOutputStreams = false;
13// Realizar el proceso
14PdfManager.AddTableOfContents(options);

Personalizando el Encabezado del TOC

Puedes personalizar el Encabezado de la Tabla de Contenidos modificando la clase TocHeading. Por ejemplo, puedes usar ‘GenerateNumbering’ o hacerlo manualmente. La propiedad ‘PageNumber’ se utiliza para los enlaces en las páginas. También puedes usar la propiedad 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// Agregar archivos de entrada y salida
10tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
11tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
12
13// Generar el TOC con opciones personalizadas
14PdfManager.AddTableOfContents(tocOptions);

Características Clave:

  • Generación Dinámica de TOC: Crea un TOC para cualquier archivo PDF con entradas generadas automáticamente basadas en encabezados o marcadores.
  • Personalización: Controla la apariencia y estructura del TOC, incluyendo estilos, formato y niveles de profundidad.
  • Flujo de Trabajo Eficiente: Minimiza el tiempo dedicado a crear TOCs manualmente, especialmente para documentos grandes o complejos.
 Español