Navigáció és műveletek

Navigáció és műveletek

Az Aspose.PDF FOSS for .NET támogatja a PDF navigációs struktúrákat — könyvjelzők (vázlatok), oldalcélok és dokumentumműveletek. Ezek lehetővé teszik interaktív dokumentumok létrehozását tartalomjegyzék-navigációval, oldalak közötti hivatkozásokkal és JavaScript-aktiválókkal.

Dokumentum vázlatok (könyvjelzők)

OutlineCollection tartalmazza a dokumentum könyvjelzőfáját. Minden OutlineItemCollection egy könyvjelző bejegyzés, amelynek címe és célpontja van.

using var doc = Document.Open(pdfBytes);

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

Könyvjelzők létrehozása

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 műveletek

GoToAction egy adott oldalra és illesztési típusra navigál ugyanabban a dokumentumban.

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

Nevezett műveletek

NamedAction előre definiált PDF megjelenítő parancsokat indít, mint a NextPage, PrevPage, FirstPage és a LastPage.

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

GoToRemote műveletek

GoToRemoteAction megnyit egy külső PDF fájlt, és egy adott oldalra navigál.

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

Műveletek indítása

LaunchAction egy külső fájlt (bármilyen formátum) nyit meg egy PDF hivatkozásból.

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

Célgyűjtemények

DestinationCollection a névvel ellátott célpontokat oldalakhoz rendeli, támogatva a kereszt-referencia navigációt nagy dokumentumokban.

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

Tippek és bevált gyakorlatok

• Építsen egy könyvjelzőfát, amely tükrözi a dokumentum szakaszhierarchiáját az intuitív navigáció érdekében.
• Használja a GoToAction-t a FitType-vel a céloldal megjelenítésének szabályozásához (szélességhez igazítás, oldalhoz igazítás stb.).
• A névvel ellátott műveletek a megjelenítőtől függnek — ragaszkodjon a szabványos nevekhez (NextPage, PrevPage, FirstPage, LastPage).
• Kereszt-dokumentum hivatkozásokhoz használja a GoToRemoteAction-t a PDF fájlokra mutató URI műveletek helyett.
• Az oldalon lévő műveletgyűjtemények lehetővé teszik több művelet hozzáadását, amelyek az oldal megnyitásakor aktiválódnak.

Gyakori problémák

GYIK

Hogyan hozhatok létre tartalomjegyzéket?

Hozzon létre OutlineItemCollection bejegyzéseket minden szakaszhoz, mindegyikben egy
GoToAction a szakasz első oldalára mutatva.

Beágyazhatok könyvjelzőket?

Igen. Adj hozzá gyermek OutlineItemCollection bejegyzéseket egy szülő könyvjelzőhöz, hogy hierarchikus vázlatot hozz létre.

Milyen illesztési típusok érhetők el a GoTo műveletekhez?

Fit, FitH (szélességhez igazítás), FitV (magassághoz igazítás), FitR (téglalaphoz igazítás), és FitB (körülhatároló dobozhoz igazítás).

API Referencia Összefoglaló

Lásd még

• Aspose.PDF for .NET Enterprise Product