Navigācija un darbības

Navigācija un darbības

Navigācija un darbības

Aspose.PDF FOSS for .NET atbalsta PDF navigācijas struktūras — grāmatzīmes (kontūras), lapas galamērķi un dokumenta darbības. Tie ļauj izveidot interaktīvus dokumentus ar satura rādītāja navigāciju, saites starp lapām un JavaScript izsaukumiem.


Dokumenta struktūras (grāmatzīmes)

OutlineCollection satur dokumenta grāmatzīmju koku. Katrs OutlineItemCollection ir grāmatzīmes ieraksts ar nosaukumu un mērķi.

using var doc = Document.Open(pdfBytes);

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

Grāmatzīmju izveide

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 darbības

GoToAction navigē uz konkrētu lapu un pielāgošanas veidu tajā pašā dokumentā.

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

Nosauktās darbības

NamedAction izsauc iepriekš definētas PDF skatītāja komandas, piemēram, NextPage, PrevPage, FirstPage un LastPage.

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

GoToRemote darbības

GoToRemoteAction atver ārēju PDF failu un pārvietojas uz konkrētu lapu.

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

Palaišanas darbības

LaunchAction atver ārēju failu (jebkuru formātu) no PDF saites.

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

Mērķa kolekcijas

DestinationCollection kartē nosauktās vietas uz lapām, atbalstot starpreferences navigāciju lielos dokumentos.

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

Padomi un labākās prakses

  • Izveidojiet grāmatzīmju koku, kas atspoguļo jūsu dokumenta sadaļu hierarhiju, lai nodrošinātu intuitīvu navigāciju.
  • Izmantojiet GoToAction ar FitType, lai kontrolētu, kā tiek attēlota mērķa lapa (pielāgot platumu, pielāgot lapu utt.).
  • Nosauktās darbības ir skatītāja atkarīgas — turieties pie standarta nosaukumiem (NextPage, PrevPage, FirstPage, LastPage).
  • Starpdokumentu saitēm izmantojiet GoToRemoteAction, nevis URI darbības, kas norāda uz PDF failiem.
  • Darbību kolekcijas lapā ļauj pievienot vairākas darbības, kas tiek izpildītas lapas atvēršanas brīdī.

Bieži sastopamās problēmas

ProblēmaIemeslsLabošana
Grāmatzīme neved uz vietuDarbība nav iestatīta izklājuma vienumamPiešķiriet GoToAction uz OutlineItemCollection.Action
GoTo darbība mērķē nepareizu lapuLapas indekss iekšēji ir 0‑bāzēts, bet lapas ir 1‑bāzētasIzmantojiet doc.Pages[n] tieši GoToAction konstruktorā
Nosauktā darbība neietekmēSkatītājs neatbalsta nosauktās darbībasIzmantojiet tikai standartnosaukumus

Biežāk uzdotie jautājumi

Kā izveidot satura rādītāju?

Izveidojiet OutlineItemCollection ierakstus katrai sadaļai, katrs ar
GoToAction, kas mērķē uz sadaļas pirmo lapu.

Vai varu ligzdot grāmatzīmes?

Jā. Pievienojiet bērna OutlineItemCollection ierakstus vecāka grāmatzīmei, lai izveidotu hierarhisku struktūru.

Kādi pielāgošanas veidi ir pieejami GoTo darbībām?

Fit, FitH (pielāgot platumu), FitV (pielāgot augstumu), FitR (pielāgot taisnstūri) un FitB (pielāgot ietvara kasti).


API atsauces kopsavilkums

Klase / MetodeApraksts
OutlineCollectionAugstākā līmeņa grāmatzīmes kolekcija dokumentā
OutlineItemCollectionViena grāmatzīmes ieraksts ar nosaukumu un darbību
GoToActionNavigēt uz lapu tajā pašā dokumentā
GoToRemoteActionNavigēt uz lapu ārējā PDF
LaunchActionAtvērt ārēju failu
NamedActionIzsaukt iepriekš definētu skatītāja komandu
PdfAction.CreateGoToRūpnīca GoTo darbībām
PdfAction.CreateNamedRūpnīca nosauktām darbībām
ActionCollectionDarbību kolekcija lapā vai anotācijā
DestinationCollectionNosauktā galamērķa reģistrs
ActionTypeUzskaitījums: GoTo, URI, JavaScript, Named, Launch

Skatiet arī

 Latviešu