Navegación y Acciones

Navegación y Acciones

Aspose.PDF FOSS for .NET admite estructuras de navegación PDF — marcadores (contornos), destinos de página y acciones de documento. Estos le permiten crear documentos interactivos con navegación de tabla de contenido, enlaces entre páginas y disparadores de JavaScript.

Esquemas de documento (marcadores)

OutlineCollection contiene el árbol de marcadores del documento. Cada OutlineItemCollection es una entrada de marcador con un título y un destino.

using var doc = Document.Open(pdfBytes);

foreach (var item in doc.Outlines)
{
    Console.WriteLine($"Bookmark: {item.Title}");
}

Creando marcadores

using var doc = Document.Open(pdfBytes);

var bookmark = new OutlineItemCollection(doc.Outlines);
bookmark.Title = "Chapter 1";
bookmark.Action = new GoToAction(doc.Pages[1]);
doc.Outlines.Add(bookmark);

doc.Save("with-bookmarks.pdf");

Acciones GoTo

GoToAction navega a una página específica y tipo de ajuste dentro del mismo documento.

var goTo = new GoToAction(doc.Pages[3]);

Acciones nombradas

NamedAction activa comandos predefinidos del visor PDF como NextPage, PrevPage, FirstPage y LastPage.

var nextPage = PdfAction.CreateNamed("NextPage");

Acciones GoToRemote

GoToRemoteAction abre un archivo PDF externo y navega a una página específica.

var remote = new GoToRemoteAction("other.pdf", 1);

Iniciar acciones

LaunchAction abre un archivo externo (cualquier formato) desde un enlace PDF.

var launch = new LaunchAction("readme.txt");

Colecciones de destino

DestinationCollection asigna destinos nombrados a páginas, soportando la navegación de referencias cruzadas en documentos extensos.

var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");

Consejos y mejores prácticas

• Cree un árbol de marcadores que refleje la jerarquía de secciones de su documento para una navegación intuitiva.
• Utilice GoToAction con FitType para controlar cómo se muestra la página de destino (ajustar ancho, ajustar página, etc.).
• Las acciones con nombre dependen del visor — manténgase con los nombres estándar (NextPage, PrevPage, FirstPage, LastPage).
• Para enlaces entre documentos, utilice GoToRemoteAction en lugar de acciones URI que apunten a archivos PDF.
• Las colecciones de acciones en una página le permiten agregar múltiples acciones que se disparan al abrir la página.

Problemas comunes

Preguntas frecuentes

¿Cómo creo una tabla de contenido?

Cree OutlineItemCollection entradas para cada sección, cada una con un
GoToAction que apunte a la primera página de la sección.

¿Puedo anidar marcadores?

Sí. Añade entradas OutlineItemCollection hijas a un marcador principal para crear un esquema jerárquico.

¿Qué tipos de ajuste están disponibles para las acciones GoTo?

Fit, FitH (ajustar ancho), FitV (ajustar altura), FitR (ajustar rectángulo), y FitB (ajustar cuadro delimitador).

Resumen de referencia de API

Ver también

• Aspose.PDF para .NET Enterprise Product