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
GoToActionmetFitTypeom 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
GoToRemoteActionin 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
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| Bladwijzer navigeert niet | Actie niet ingesteld op het outline-item | Wijs een GoToAction toe aan OutlineItemCollection.Action |
| GoTo actie richt zich op verkeerde pagina | Pagina-index is intern 0-gebaseerd maar pagina’s zijn 1-gebaseerd | Gebruik doc.Pages[n] direct in de GoToAction constructor |
| Naamgegeven actie heeft geen effect | Viewer ondersteunt de naamgegeven actie niet | Gebruik 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 / Methode | Beschrijving |
|---|---|
OutlineCollection | Topniveau bladwijzerverzameling op het document |
OutlineItemCollection | Enkele bladwijzervermelding met titel en actie |
GoToAction | Navigeer naar een pagina binnen hetzelfde document |
GoToRemoteAction | Navigeer naar een pagina in een externe PDF |
LaunchAction | Open een extern bestand |
NamedAction | Activeer een vooraf gedefinieerde viewer-opdracht |
PdfAction.CreateGoTo | Fabriek voor GoTo acties |
PdfAction.CreateNamed | Fabriek voor genaamde acties |
ActionCollection | Collectie van acties op een pagina of annotatie |
DestinationCollection | Genaamd bestemmingsregister |
ActionType | Enumeratie: GoTo, URI, JavaScript, Genaamd, Start |