Navigace a akce

Navigace a akce

Aspose.PDF FOSS for .NET podporuje navigační struktury PDF — záložky (obrysy), cíle stránek a akce dokumentu. To vám umožní vytvářet interaktivní dokumenty s navigací pomocí obsahu, odkazy mezi stránkami a spouštěči JavaScriptu.

Osnova dokumentu (záložky)

OutlineCollection obsahuje strom záložek dokumentu. Každý OutlineItemCollection je položka záložky s názvem a cílem.

using var doc = Document.Open(pdfBytes);

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

Vytváření záložek

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 akce

GoToAction naviguje na konkrétní stránku a typ přizpůsobení v rámci stejného dokumentu.

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

Pojmenované akce

NamedAction spouští předdefinované příkazy prohlížeče PDF jako NextPage, PrevPage, FirstPage a LastPage.

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

GoToRemote akce

GoToRemoteAction otevře externí soubor PDF a přejde na konkrétní stránku.

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

Spustit akce

LaunchAction otevře externí soubor (libovolného formátu) z odkazu PDF.

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

Cílové kolekce

DestinationCollection mapuje pojmenované cíle na stránky, podporuje navigaci pomocí křížových odkazů ve velkých dokumentech.

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

Tipy a osvědčené postupy

• Vytvořte strom záložek, který odráží hierarchii sekcí vašeho dokumentu pro intuitivní navigaci.
• Použijte GoToAction s FitType k řízení způsobu zobrazení cílové stránky (fit width, fit page, atd.).
• Pojmenované akce jsou závislé na prohlížeči — držte se standardních názvů (NextPage, PrevPage, FirstPage, LastPage).
• Pro odkazy mezi dokumenty použijte GoToRemoteAction místo URI akcí směřujících na soubory PDF.
• Kolekce akcí na stránce vám umožňují přidat více akcí, které se spustí při otevření stránky.

Časté problémy

Často kladené otázky

Jak vytvořit obsah?

Vytvořte OutlineItemCollection položky pro každou sekci, každou s
GoToAction zaměřenou na první stránku sekce.

Mohu vnořit záložky?

Ano. Přidejte podřízené položky OutlineItemCollection do nadřazené záložky pro vytvoření hierarchické osnovy.

Jaké typy přizpůsobení jsou k dispozici pro akce GoTo?

Fit, FitH (přizpůsobit šířce), FitV (přizpůsobit výšce), FitR (přizpůsobit obdélníku) a FitB (přizpůsobit ohraničujícímu rámečku).

Přehled referenčního API

Viz také

• Aspose.PDF pro .NET Enterprise Product