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ä
GoToActionyhdessä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
| Ongelma | Syy | Korjaus |
|---|---|---|
| Kirjanmerkki ei navigoi | Toimintoa ei ole asetettu sisennyskohteelle | Määritä GoToAction OutlineItemCollection.Action:lle |
| GoTo-toiminto kohdistaa väärälle sivulle | Sivun indeksi on sisäisesti 0-pohjainen, mutta sivut ovat 1-pohjaisia | Käytä doc.Pages[n] suoraan GoToAction-konstruktiossa |
| Nimetyllä toiminnolla ei ole vaikutusta | Katsoja ei tue nimettyä toimintoa | Käytä vain standardinimiä |
UKK
Kuinka luon sisällysluettelon?
Luo OutlineItemCollection merkinnät jokaiselle osiolle, jokainenGoToAction 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 / Metodi | Kuvaus |
|---|---|
OutlineCollection | Asiakirjan ylimmän tason kirjanmerkkikokoelma |
OutlineItemCollection | Yksittäinen kirjanmerkkimerkintä, jossa on otsikko ja toiminto |
GoToAction | Siirry sivulle samassa asiakirjassa |
GoToRemoteAction | Siirry sivulle ulkoisessa PDF-tiedostossa |
LaunchAction | Avaa ulkoinen tiedosto |
NamedAction | Käynnistä ennalta määritetty katselukomento |
PdfAction.CreateGoTo | Tehdas GoTo-toiminnoille |
PdfAction.CreateNamed | Tehdas nimetyille toiminnoille |
ActionCollection | Toimintojen kokoelma sivulla tai merkinnässä |
DestinationCollection | Nimettyjen kohteiden rekisteri |
ActionType | Luettelo: GoTo, URI, JavaScript, Named, Launch |