Navigácia a akcie

Navigácia a akcie

Aspose.PDF FOSS for .NET podporuje PDF navigačné štruktúry — záložky (obsahy), cieľové stránky a akcie dokumentu. To vám umožní vytvárať interaktívne dokumenty s navigáciou pomocou obsahu, prepojeniami medzi stránkami a spúšťačmi JavaScriptu.

Obrysy dokumentu (záložky)

OutlineCollection obsahuje strom záložiek dokumentu. Každý OutlineItemCollection je položka záložky s názvom a cieľom.

using var doc = Document.Open(pdfBytes);

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

Vytváranie záložiek

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 akcie

GoToAction naviguje na konkrétnu stránku a typ prispôsobenia v rovnakom dokumente.

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

Pomenované akcie

NamedAction spúšťa preddefinované príkazy prehliadača PDF, ako NextPage, PrevPage, FirstPage a LastPage.

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

GoToRemote akcie

GoToRemoteAction otvorí externý PDF súbor a prejde na konkrétnu stránku.

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

Spustiť akcie

LaunchAction otvorí externý súbor (akýkoľvek formát) z odkazu PDF.

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

Cieľové kolekcie

DestinationCollection mapuje pomenované destinácie na stránky, podporuje navigáciu cez krížové odkazy vo veľkých dokumentoch.

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

Tipy a osvedčené postupy

• Vytvorte strom záložiek, ktorý odráža hierarchiu sekcií dokumentu pre intuitívnu navigáciu.
• Použite GoToAction s FitType na ovládanie spôsobu zobrazenia cieľovej stránky (prispôsobiť šírke, prispôsobiť stránke atď.).
• Pomenované akcie sú závislé od prehliadača — používajte štandardné názvy (NextPage, PrevPage, FirstPage, LastPage).
• Pre odkazy medzi dokumentmi použite GoToRemoteAction namiesto URI akcií smerujúcich na súbory PDF.
• Zbierky akcií na stránke vám umožňujú pridať viacero akcií, ktoré sa spustia pri otvorení stránky.

Bežné problémy

Často kladené otázky

Ako vytvoriť tabuľku obsahu?

Vytvorte OutlineItemCollection položky pre každú sekciu, každú s
GoToAction smerujúcou na prvú stránku sekcie.

Môžem vnoriť záložky?

Áno. Pridajte podriadené položky OutlineItemCollection do rodičovskej záložky, aby ste vytvorili hierarchický prehľad.

Aké typy prispôsobenia sú k dispozícii pre akcie GoTo?

Fit, FitH (prispôsobiť šírku), FitV (prispôsobiť výšku), FitR (prispôsobiť obdĺžnik) a FitB (prispôsobiť ohraničujúcu krabicu).

Zhrnutie referencie API

Pozri tiež

• Aspose.PDF for .NET Enterprise produkt