Navigacija i akcije

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 GoToAction zajedno sa FitType da 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 GoToRemoteAction umesto 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

ProblemUzrokRešenje
Obeleživač ne navigiraAkcija nije postavljena na stavku struktureDodelite GoToAction na OutlineItemCollection.Action
GoTo akcija cilja pogrešnu stranicuIndeks stranice je interno 0‑baziran, ali su stranice 1‑baziraneKoristite doc.Pages[n] direktno u konstruktoru GoToAction
Imenovana akcija nema efektaPregledač ne podržava imenovanu akcijuKoristite 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 / MethodDescription
OutlineCollectionKolekcija oznaka najvišeg nivoa u dokumentu
OutlineItemCollectionPojedinačni unos oznake sa naslovom i radnjom
GoToActionNavigacija na stranicu unutar istog dokumenta
GoToRemoteActionNavigacija na stranicu u eksternom PDF‑u
LaunchActionOtvaranje eksternog fajla
NamedActionPokretanje unapred definisane komande preglednika
PdfAction.CreateGoToFabrika za GoTo radnje
PdfAction.CreateNamedFabrika za imenovane radnje
ActionCollectionKolekcija radnji na stranici ili anotaciji
DestinationCollectionRegistar imenovanih destinacija
ActionTypeEnumeracija: GoTo, URI, JavaScript, Named, Launch

Vidi takođe

 Српски