Navigasjon og handlinger

Navigering og handlinger

Aspose.PDF FOSS for .NET støtter PDF-navigasjonsstrukturer — bokmerker (oversikter), sidemål og dokumenthandlinger. Disse gjør det mulig å lage interaktive dokumenter med navigasjon i innholdsfortegnelsen, kryss‑sidelinker og JavaScript‑utløsere.

Dokumentoversikter (bokmerker)

OutlineCollection inneholder dokumentets bokmerkestruktur. Hver OutlineItemCollection er en bokmerkepost med en tittel og destinasjon.

using var doc = Document.Open(pdfBytes);

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

Opprette bokmerker

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‑handlinger

GoToAction navigerer til en spesifikk side og tilpasningstype innenfor samme dokument.

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

Navngitte handlinger

NamedAction utløser forhåndsdefinerte PDF‑viserk kommandoer som NextPage, PrevPage, FirstPage og LastPage.

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

GoToRemote handlinger

GoToRemoteAction åpner en ekstern PDF‑fil og navigerer til en spesifikk side.

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

Start handlinger

LaunchAction åpner en ekstern fil (hvilket som helst format) fra en PDF‑lenke.

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

Destinasjonssamlinger

DestinationCollection kartlegger navngitte destinasjoner til sider, og støtter kryssreferanse‑navigasjon i store dokumenter.

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

Tips og beste praksis

• Bygg et bokmerkestruktur som speiler dokumentets seksjonshierarki for intuitiv navigering.
• Bruk GoToAction med FitType for å kontrollere hvordan målsiden vises (tilpass bredde, tilpass side, osv.).
• Navngitte handlinger er avhengige av viseren — hold deg til standardnavn (NextPage, PrevPage, FirstPage, LastPage).
• For kryssdokumentlenker, bruk GoToRemoteAction i stedet for URI-handlinger som peker til PDF-filer.
• Handlingssamlinger på en side lar deg legge til flere handlinger som utløses ved sideåpning.

Vanlige problemer

Ofte stilte spørsmål

Hvordan lager jeg en innholdsfortegnelse?

Opprett OutlineItemCollection-oppføringer for hver seksjon, hver med en GoToAction som retter seg mot seksjonens første side.

Kan jeg nest bokmerker?

Ja. Legg til underoppføringer OutlineItemCollection i et overordnet bokmerke for å lage en hierarkisk disposisjon.

Hvilke tilpasningstyper er tilgjengelige for GoTo-handlinger?

Fit, FitH (tilpass bredde), FitV (tilpass høyde), FitR (tilpass rektangel), og FitB (tilpass begrensningsboks).

API-referansesammendrag

Se også

• Aspose.PDF for .NET Enterprise-produkt