Navigacija i akcije
Navigacija i akcije
Aspose.PDF FOSS za .NET podržava PDF navigacione strukture — oznake (obrasce), odredišta stranica i radnje dokumenta. Ovo vam omogućava da kreirate interaktivne dokumente sa navigacijom kroz tabelu sadržaja, linkovima između stranica i JavaScript okidačima.
Контуре документа (обележивачи)
OutlineCollection sadrži stablo oznaka dokumenta. Svaki OutlineItemCollection je unos oznake sa naslovom i odredištem.
using var doc = Document.Open(pdfBytes);
foreach (var item in doc.Outlines)
{
Console.WriteLine($"Bookmark: {item.Title}");
}Kreiranje obeleživača
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 akcije
GoToAction навигација до одређене странице и типа уклапања унутар истог документа.
var goTo = new GoToAction(doc.Pages[3]);Imenovane akcije
NamedAction pokreće predefinisane komande PDF pregledača kao što su NextPage, PrevPage, FirstPage i LastPage.
var nextPage = PdfAction.CreateNamed("NextPage");GoToRemote akcije
GoToRemoteAction otvara eksternu PDF datoteku i navigira do određene stranice.
var remote = new GoToRemoteAction("other.pdf", 1);Pokreni radnje
LaunchAction otvara eksternu datoteku (bilo koji format) sa PDF linka.
var launch = new LaunchAction("readme.txt");Odredišne kolekcije
DestinationCollection mapira imenovane destinacije na stranice, podržavajući navigaciju unakrsnim referencama u velikim dokumentima.
var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");Saveti i najbolje prakse
- Izgradite stablo oznaka koje odražava hijerarhiju sekcija vašeg dokumenta radi intuitivne navigacije.
- Koristite
GoToActionzajedno saFitTypeda biste kontrolisali kako se prikazuje ciljna stranica (prilagodi širini, prilagodi stranici, itd.). - Imenovane radnje zavise od pregledača — držite se standardnih imena (NextPage, PrevPage, FirstPage, LastPage).
- Za veze između dokumenata, koristite
GoToRemoteActionumesto URI radnji koje upućuju na PDF fajlove. - Kolekcije radnji na stranici omogućavaju vam da dodate više radnji koje se aktiviraju prilikom otvaranja stranice.
Česti problemi
| Problem | Uzrok | Rešenje |
|---|---|---|
| Obeleživač ne navigira | Akcija nije postavljena na stavku strukture | Dodelite GoToAction na OutlineItemCollection.Action |
| GoTo akcija cilja pogrešnu stranicu | Indeks stranice je interno 0‑baziran, ali su stranice 1‑bazirane | Koristite doc.Pages[n] direktno u konstruktoru GoToAction |
| Imenovana akcija nema efekta | Pregledač ne podržava imenovanu akciju | Koristite samo standardna imena |
ČPP
Kako da napravim tabelu sadržaja?
Kreirajte OutlineItemCollection unose za svaku sekciju, svaki sa
GoToAction koji cilja prvu stranicu sekcije.
Могу ли да угнездим обележиваче?
Da. Dodajte pod OutlineItemCollection unose u roditeljski obeleživač da biste kreirali hijerarhijski prikaz.
Koje vrste uklapanja su dostupne za GoTo akcije?
Fit, FitH (prilagodi širinu), FitV (prilagodi visinu), FitR (prilagodi pravougaonik), i FitB
(prilagodi okvir).
Сажетак референци API
| Class / Method | Description |
|---|---|
OutlineCollection | Kolekcija oznaka najvišeg nivoa u dokumentu |
OutlineItemCollection | Pojedinačni unos oznake sa naslovom i radnjom |
GoToAction | Navigacija na stranicu unutar istog dokumenta |
GoToRemoteAction | Navigacija na stranicu u eksternom PDF‑u |
LaunchAction | Otvaranje eksternog fajla |
NamedAction | Pokretanje unapred definisane komande preglednika |
PdfAction.CreateGoTo | Fabrika za GoTo radnje |
PdfAction.CreateNamed | Fabrika za imenovane radnje |
ActionCollection | Kolekcija radnji na stranici ili anotaciji |
DestinationCollection | Registar imenovanih destinacija |
ActionType | Enumeracija: GoTo, URI, JavaScript, Named, Launch |