Navigointi ja toiminnot

Navigointi ja toiminnot

Aspose.PDF FOSS for .NET tukee PDF:n navigaatiorakenteita — kirjanmerkit (rakenne), sivukohteet ja asiakirjatoiminnot. Nämä mahdollistavat interaktiivisten asiakirjojen luomisen sisällysluettelon navigoinnilla, sivujen väliset linkit ja JavaScript-liipaisimet.


Asiakirjan sisällysluettelot (kirjanmerkit)

OutlineCollection sisältää asiakirjan kirjanmerkkipuun. Jokainen OutlineItemCollection on kirjanmerkki, jossa on otsikko ja kohde.

using var doc = Document.Open(pdfBytes);

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

Kirjanmerkkien luominen

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-toiminnot

GoToAction navigoi tietylle sivulle ja sovitustyypille samassa asiakirjassa.

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

Nimetyt toiminnot

NamedAction käynnistää ennalta määritetyt PDF‑katselimen komennot, kuten NextPage, PrevPage, FirstPage ja LastPage.

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

GoToRemote-toiminnot

GoToRemoteAction avaa ulkoisen PDF-tiedoston ja siirtyy tietylle sivulle.

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

Käynnistä toiminnot

LaunchAction avaa ulkoisen tiedoston (mikä tahansa formaatti) PDF-linkistä.

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

Kohdekokoelmat

DestinationCollection kartoittaa nimettyjä kohteita sivuille, tukien viitteiden välistä navigointia suurissa asiakirjoissa.

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

Vinkkejä ja parhaita käytäntöjä

  • Rakenna kirjanmerkkipuu, joka heijastaa asiakirjasi osiohierarkiaa, jotta navigointi olisi intuitiivista.
  • Käytä GoToAction yhdessä FitType:n kanssa hallitaksesi, miten kohdesivu näytetään (sovita leveys, sovita sivu jne.).
  • Nimetyillä toimilla on katselijasta riippuvainen käyttäytyminen — pysy standardinimissä (NextPage, PrevPage, FirstPage, LastPage).
  • Asiakirjojen välisten linkkien osalta käytä GoToRemoteAction:ää sen sijaan, että käyttäisit URI‑toimintoja, jotka osoittavat PDF‑tiedostoihin.
  • Toimintokokoelmat sivulla antavat mahdollisuuden lisätä useita toimintoja, jotka käynnistyvät sivun avautuessa.

Yleiset ongelmat

OngelmaSyyKorjaus
Kirjanmerkki ei navigoiToimintoa ei ole asetettu sisennyskohteelleMääritä GoToAction OutlineItemCollection.Action:lle
GoTo-toiminto kohdistaa väärälle sivulleSivun indeksi on sisäisesti 0-pohjainen, mutta sivut ovat 1-pohjaisiaKäytä doc.Pages[n] suoraan GoToAction-konstruktiossa
Nimetyllä toiminnolla ei ole vaikutustaKatsoja ei tue nimettyä toimintoaKäytä vain standardinimiä

UKK

Kuinka luon sisällysluettelon?

Luo OutlineItemCollection merkinnät jokaiselle osiolle, jokainen
GoToAction kohdistettuna osion ensimmäiselle sivulle.

Voinko sisäkkäistää kirjanmerkit?

Kyllä. Lisää lapsi OutlineItemCollection merkinnät vanhempaan kirjanmerkkiin luodaksesi hierarkkisen sisällyksen.

Mitä sovitustyyppejä on saatavilla GoTo-toiminnoille?

Fit, FitH (sovita leveys), FitV (sovita korkeus), FitR (sovita suorakulmio) ja FitB (sovita rajaava laatikko).


API-viittauksen yhteenveto

Luokka / MetodiKuvaus
OutlineCollectionAsiakirjan ylimmän tason kirjanmerkkikokoelma
OutlineItemCollectionYksittäinen kirjanmerkkimerkintä, jossa on otsikko ja toiminto
GoToActionSiirry sivulle samassa asiakirjassa
GoToRemoteActionSiirry sivulle ulkoisessa PDF-tiedostossa
LaunchActionAvaa ulkoinen tiedosto
NamedActionKäynnistä ennalta määritetty katselukomento
PdfAction.CreateGoToTehdas GoTo-toiminnoille
PdfAction.CreateNamedTehdas nimetyille toiminnoille
ActionCollectionToimintojen kokoelma sivulla tai merkinnässä
DestinationCollectionNimettyjen kohteiden rekisteri
ActionTypeLuettelo: GoTo, URI, JavaScript, Named, Launch

Katso myös

 Suomi