Navigatie en Acties

Navigatie en Acties

Aspose.PDF FOSS voor .NET ondersteunt PDF-navigatiestructuren — bladwijzers (overzichten), paginabestemmingen en documentacties. Deze stellen je in staat interactieve documenten te maken met inhoudsopgave-navigatie, kruis-pagina links, en JavaScript triggers.


Documentoverzichten (bladwijzers)

OutlineCollection bevat de bladwijzerboom van het document. Elke OutlineItemCollection is een bladwijzervermelding met een titel en bestemming.

using var doc = Document.Open(pdfBytes);

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

Bladwijzers maken

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

GoTo acties

GoToAction navigeert naar een specifieke pagina en passtype binnen hetzelfde document.

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

Genaamde acties

NamedAction activeert vooraf gedefinieerde PDF-viewercommando’s zoals NextPage, PrevPage, FirstPage en LastPage.

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

GoToRemote acties

GoToRemoteAction opent een extern PDF-bestand en navigeert naar een specifieke pagina.

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

Startacties

LaunchAction opent een extern bestand (elk formaat) vanuit een PDF-link.

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

Bestemmingscollecties

DestinationCollection koppelt benoemde bestemmingen aan pagina’s, waardoor kruisverwijzingsnavigatie in grote documenten wordt ondersteund.

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

Tips en best practices

  • Bouw een bladwijzertboom die de sectiehiërarchie van uw document weerspiegelt voor intuïtieve navigatie.
  • Gebruik GoToAction met FitType om te bepalen hoe de doelpagina wordt weergegeven (breedte aanpassen, pagina aanpassen, enz.).
  • Naamgegeven acties zijn viewer-afhankelijk — houd u aan standaardnamen (NextPage, PrevPage, FirstPage, LastPage).
  • Gebruik voor cross-documentkoppelingen GoToRemoteAction in plaats van URI-acties die naar PDF-bestanden wijzen.
  • Actieverzamelingen op een pagina laten u meerdere acties toevoegen die worden geactiveerd bij het openen van de pagina.

Veelvoorkomende problemen

ProbleemOorzaakOplossing
Bladwijzer navigeert nietActie niet ingesteld op het outline-itemWijs een GoToAction toe aan OutlineItemCollection.Action
GoTo actie richt zich op verkeerde paginaPagina-index is intern 0-gebaseerd maar pagina’s zijn 1-gebaseerdGebruik doc.Pages[n] direct in de GoToAction constructor
Naamgegeven actie heeft geen effectViewer ondersteunt de naamgegeven actie nietGebruik alleen standaardnamen

FAQ

Hoe maak ik een inhoudsopgave?

Maak OutlineItemCollection vermeldingen voor elke sectie, elk met een GoToAction die naar de eerste pagina van de sectie verwijst.

Kan ik bladwijzers nesten?

Ja. Voeg onderliggende OutlineItemCollection vermeldingen toe aan een bovenliggende bladwijzer om een hiërarchische structuur te creëren.

Welke fit-typen zijn beschikbaar voor GoTo acties?

Fit, FitH (fit width), FitV (fit height), FitR (fit rectangle), en FitB (fit bounding box).


API Reference Samenvatting

Klasse / MethodeBeschrijving
OutlineCollectionTopniveau bladwijzerverzameling op het document
OutlineItemCollectionEnkele bladwijzervermelding met titel en actie
GoToActionNavigeer naar een pagina binnen hetzelfde document
GoToRemoteActionNavigeer naar een pagina in een externe PDF
LaunchActionOpen een extern bestand
NamedActionActiveer een vooraf gedefinieerde viewer-opdracht
PdfAction.CreateGoToFabriek voor GoTo acties
PdfAction.CreateNamedFabriek voor genaamde acties
ActionCollectionCollectie van acties op een pagina of annotatie
DestinationCollectionGenaamd bestemmingsregister
ActionTypeEnumeratie: GoTo, URI, JavaScript, Genaamd, Start

Zie ook

 Nederlands