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
GoToActionmedFitTypeKontrollera 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
GoToRemoteActionI 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
| Issue | Cause | Fixar |
|---|---|---|
| Bookmark navigerar inte | Aktion inte angivna på utgångspunkten | Tilldelar A GoToAction till OutlineItemCollection.Action |
| GoTo-åtgärder tar upp fel sida | Page index är 0-baserad intern men sidor är 1-baserade | Användning doc.Pages[n] direkt i GoToAction-konstruktorn |
| Den namngivna åtgärden har ingen effekt | Vyn stöder inte den namngivna åtgärden | Anvä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 / Metod | Beskrivning |
|---|---|
OutlineCollection | Top-nivå bokmärkning på dokumentet |
OutlineItemCollection | Enstaka bokmärke med titel och handling |
GoToAction | Navigera till en sida inom samma dokument |
GoToRemoteAction | Navigera till en sida i ett externt PDF-format |
LaunchAction | Öppna en extern fil |
NamedAction | Trigger en fördefinierad tittarkommando |
PdfAction.CreateGoTo | Fabrik för GoTo-åtgärder |
PdfAction.CreateNamed | Fabrik för namngivna åtgärder |
ActionCollection | Samla åtgärder på en sida eller anteckningar |
DestinationCollection | Namn destinationregistret |
ActionType | Förteckning: GoTo, URI, JavaScript, Namnade, Lansering |