Navigation och åtgärder

Navigation och åtgärder

Navigation och åtgärder

Aspose.PDF FOSS for .NET supports PDF navigation structures — bookmarks (outlines), page destinations, and document actions. These let you create interactive documents with table-of-contents navigation, cross-page links, and JavaScript triggers.


Dokumentutskrifter (bookmarks)

OutlineCollection Håller dokumentets bokmärke träd. var och en OutlineItemCollection är en bokmärke med titel och destination.

using var doc = Document.Open(pdfBytes);

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

Skapa bokmärken

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 åtgärder

GoToAction navigerar till en viss sida och passar typ inom samma Dokumentet är.

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

Namngivna åtgärder

NamedAction trigger fördefinierade PDF-visorer kommandon som NextPage, Första sidan, första sidan och sista sidan.

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

GoToRemote åtgärder

GoToRemoteAction öppnar en extern PDF-fil och navigerar till en specifik sidan .

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

Startar åtgärder

LaunchAction Öppnar en extern fil (alla format) från en PDF-länk.

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

Destination samlingar

DestinationCollection kartor som namngav destinationer till sidor, stödja Cross-referens navigering i stora dokument.

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

Tips och bästa praxis

  • Bygg ett bokmärke som speglar dokumentets sektionshierark för intuitiv navigation.
  • Användning GoToAction med FitType Kontrollera hur målsidan visas (fit width, fit page etc.).
  • Namngivna åtgärder är visuellt beroende - klicka på standardnamn (NextPage, PrevPages, FirstPays, LastPags).
  • För cross-dokument länkar, användning GoToRemoteAction I stället för URI-åtgärder som pekar på PDF-filer.
  • Aktionssamlingar på en sida låter dig lägga till flera åtgärder som brinner på sidan öppen.

Vanliga frågor

IssueCauseFixar
Bookmark navigerar inteAktion inte angivna på utgångspunktenTilldelar A GoToAction till OutlineItemCollection.Action
GoTo-åtgärder tar upp fel sidaPage index är 0-baserad intern men sidor är 1-baseradeAnvändning doc.Pages[n] direkt i GoToAction-konstruktorn
Den namngivna åtgärden har ingen effektVyn stöder inte den namngivna åtgärdenAnvänd bara standardnamn

FAQ

Hur skapar jag en innehållstabell?

Skapa OutlineItemCollection för varje avsnitt, var och en med ett GoToAction Målning av sektionens första sida.

Kan jag inte ta bokmärken?

Ja, ta med barn OutlineItemCollection Inträde till en föräldralös bokmärke för att skapa en hierarkisk utgångspunkt.

Vilka typer av fit finns tillgängliga för GoTo-åtgärder?

Fit, FitH (Fit bredd), FitV (fit höjd), FITR (fit rektangle) och FitB (främjande box).


API Referens sammanfattning

Klass / MetodBeskrivning
OutlineCollectionTop-nivå bokmärkning på dokumentet
OutlineItemCollectionEnstaka bokmärke med titel och handling
GoToActionNavigera till en sida inom samma dokument
GoToRemoteActionNavigera till en sida i ett externt PDF-format
LaunchActionÖppna en extern fil
NamedActionTrigger en fördefinierad tittarkommando
PdfAction.CreateGoToFabrik för GoTo-åtgärder
PdfAction.CreateNamedFabrik för namngivna åtgärder
ActionCollectionSamla åtgärder på en sida eller anteckningar
DestinationCollectionNamn destinationregistret
ActionTypeFörteckning: GoTo, URI, JavaScript, Namnade, Lansering

Se även

 Svenska