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
GoToActionarFitType, 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ēma | Iemesls | Labošana |
|---|---|---|
| Grāmatzīme neved uz vietu | Darbība nav iestatīta izklājuma vienumam | Piešķiriet GoToAction uz OutlineItemCollection.Action |
| GoTo darbība mērķē nepareizu lapu | Lapas indekss iekšēji ir 0‑bāzēts, bet lapas ir 1‑bāzētas | Izmantojiet doc.Pages[n] tieši GoToAction konstruktorā |
| Nosauktā darbība neietekmē | Skatītājs neatbalsta nosauktās darbības | Izmantojiet tikai standartnosaukumus |
Biežāk uzdotie jautājumi
Kā izveidot satura rādītāju?
Izveidojiet OutlineItemCollection ierakstus katrai sadaļai, katrs arGoToAction, 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 / Metode | Apraksts |
|---|---|
OutlineCollection | Augstākā līmeņa grāmatzīmes kolekcija dokumentā |
OutlineItemCollection | Viena grāmatzīmes ieraksts ar nosaukumu un darbību |
GoToAction | Navigēt uz lapu tajā pašā dokumentā |
GoToRemoteAction | Navigēt uz lapu ārējā PDF |
LaunchAction | Atvērt ārēju failu |
NamedAction | Izsaukt iepriekš definētu skatītāja komandu |
PdfAction.CreateGoTo | Rūpnīca GoTo darbībām |
PdfAction.CreateNamed | Rūpnīca nosauktām darbībām |
ActionCollection | Darbību kolekcija lapā vai anotācijā |
DestinationCollection | Nosauktā galamērķa reģistrs |
ActionType | Uzskaitījums: GoTo, URI, JavaScript, Named, Launch |