Navegació i Accions

Navegació i Accions

Aspose.PDF FOSS for .NET admet estructures de navegació PDF — marcadors (contorns), destinacions de pàgina i accions de document. Això us permet crear documents interactius amb navegació de taula de continguts, enllaços entre pàgines i desencadenadors JavaScript.

Esquema del document (marcadors)

OutlineCollection conté l’arbre de marcadors del document. Cada OutlineItemCollection és una entrada de marcador amb un títol i una destinació.

using var doc = Document.Open(pdfBytes);

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

Creant marcadors

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");

accions GoTo

GoToAction navega a una pàgina específica i tipus d’ajust dins del mateix document.

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

Accions amb nom

NamedAction desencadena ordres predefinides del visualitzador PDF com NextPage, PrevPage, FirstPage i LastPage.

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

Accions GoToRemote

GoToRemoteAction obre un fitxer PDF extern i navega cap a una pàgina específica.

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

Iniciar accions

LaunchAction obre un fitxer extern (qualsevol format) des d’un enllaç PDF.

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

Col·leccions de destinació

DestinationCollection assigna destinacions amb nom a pàgines, admetent la navegació de referències creuades en documents grans.

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

Consells i bones pràctiques

• Creeu un arbre de marcadors que reflecteixi la jerarquia de seccions del vostre document per a una navegació intuïtiva.
• Utilitzeu GoToAction amb FitType per controlar com es mostra la pàgina de destinació (ajustar amplada, ajustar pàgina, etc.).
• Les accions amb nom depenen del visualitzador — mantingueu-vos amb noms estàndard (NextPage, PrevPage, FirstPage, LastPage).
• Per a enllaços entre documents, utilitzeu GoToRemoteAction en lloc d’accions URI que apunten a fitxers PDF.
• Les col·leccions d’accions en una pàgina us permeten afegir diverses accions que s’executen en obrir la pàgina.

Problemes comuns

PMF

Com creo una taula de continguts?

Creeu OutlineItemCollection entrades per a cada secció, cadascuna amb un
GoToAction que apunti a la primera pàgina de la secció.

Puc anidar marcadors?

Sí. Afegeix entrades fill OutlineItemCollection a un marcador pare per crear un esquema jeràrquic.

Quins tipus d’ajust estan disponibles per a les accions GoTo?

Fit, FitH (ajustar amplada), FitV (ajustar alçada), FitR (ajustar rectangle) i FitB (ajustar caixa delimitadora).

Resum de la referència de l’API

Vegeu també

• Producte Enterprise d’Aspose.PDF per a .NET