Ναυτιλία και δράσεις
Ναυτιλία και δράσεις
Aspose.PDF FOSS for .NET supports PDF navigation structures — bookmarks (outlines), page destinations, and document actions. These let you create interactive documents with table-of-contents navigation, cross-page links, and JavaScript triggers.
Ετικέτες (bookmarks )
OutlineCollection Το δέντρο του βιβλίου είναι το δένδρο.Κάθε OutlineItemCollection Είναι μια εισαγωγή με τίτλο και προορισμό.
using var doc = Document.Open(pdfBytes);
foreach (var item in doc.Outlines)
{
Console.WriteLine($"Bookmark: {item.Title}");
}Δημιουργία βιβλιογραφιών
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");ΓΟΤΟ ΔΡΑΣΕΙΣ
GoToAction πλοήγηση σε μια συγκεκριμένη σελίδα και ταιριάζει τύπο μέσα στο ίδιο Το έγγραφο.
var goTo = new GoToAction(doc.Pages[3]);Ονομαστικές ενέργειες
NamedAction εκκινεί προκαθορισμένες εντολές PDF προβολής, όπως το NextPage, Πρώτη σελίδα, πρώτος και τελευταίος.
var nextPage = PdfAction.CreateNamed("NextPage");Απομακρυσμένες δράσεις
GoToRemoteAction ανοίγει ένα εξωτερικό αρχείο PDF και πλοηγείται σε συγκεκριμένο Η σελίδα.
var remote = new GoToRemoteAction("other.pdf", 1);Ξεκινάει δράση
LaunchAction ανοίγει ένα εξωτερικό αρχείο (όποια μορφή) από μια σύνδεση PDF.
var launch = new LaunchAction("readme.txt");Συλλογή προορισμών
DestinationCollection χάρτες που ονομάζονται προορισμοί σε σελίδες, υποστηρίζοντας διασταύρωση των εγγράφων σε μεγάλα έγγραφα.
var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");Συμβουλές και βέλτιστες πρακτικές
- Κατασκευάστε ένα δέντρο σημειωματάριο που καθρέφεται στην ιεραρχία τμήματος του εγγράφου σας για διαισθητική πλοήγηση.
- Χρησιμοποιήστε
GoToActionΜεFitTypeΓια να ελέγξετε πώς εμφανίζεται η σελίδα στόχου (κατάλληλη πλάτος, κατάλληλης σελίδας κλπ.). - Οι ονομαζόμενες ενέργειες είναι προβολείς-εξαρτώμενες - παρακολουθήστε τα τυποποιημένα ονόματα (NextPage, PrevPages, FirstPAGE, LastPAGE).
- Για διασυνδέσεις με έγγραφα, χρησιμοποιήστε
GoToRemoteActionαντί για δράσεις URI που υποδεικνύουν τα αρχεία PDF. - Οι συλλογές δράσης σε μια σελίδα σας επιτρέπουν να προσθέσετε πολλές ενέργειες που καίγονται στην ανοιχτή σελίδα.
κοινά ζητήματα
| Θέμα | Αιτία | ΦΙΛΕΞΗ |
|---|---|---|
| Το Bookmark δεν πλοηγείται | Η δράση δεν έχει καθοριστεί στο στοιχείο εξόδου | ΑΙΤΗΣΗ A GoToAction Για να OutlineItemCollection.Action |
| Στόχοι δράσης GoTo σε λάθος σελίδα | Ο δείκτης σελίδων είναι 0-based internally, αλλά οι σελίδες είναι 1-based. | Χρησιμοποιήστε doc.Pages[n] Εξυπηρετείται από τον κατασκευαστή GoToAction |
| Η ονομαστική δράση δεν έχει αποτέλεσμα. | Ο προβολέας δεν υποστηρίζει την ονομαστική δράση | Χρησιμοποιήστε μόνο τα τυποποιημένα ονόματα |
FAQ
Πώς μπορώ να δημιουργήσω έναν πίνακα περιεχομένου;?
Δημιουργία OutlineItemCollection κάθε τμήμα, με το καθένα ένα GoToAction Στόχος της πρώτης σελίδας του τμήματος.
Μπορώ να βάλω τα βιβλία;?
Ναι, προσθέστε το παιδί OutlineItemCollection εισαγωγή σε ένα γονικό σημειωματάριο για να δημιουργήσετε Μια ιεραρχική έκθεση.
Ποια είδη ταιριάσεων είναι διαθέσιμα για τις δράσεις GoTo;?
Fit, FitH (υποδεκτή πλάτος), FitV (εποδοτική ύψος), fitR (απλή ορθογώνιο) και FitB (συνοριακό κουτί).
Συνοπτική αναφορά API
| Κλάση / Μέθοδος | Περιγραφή |
|---|---|
OutlineCollection | Η συλλογή κορυφαίων σημειώσεων στο έγγραφο |
OutlineItemCollection | Εναλλακτική εισαγωγή με τίτλο και δράση |
GoToAction | Να πλοηγηθείτε σε μια σελίδα στο ίδιο έγγραφο |
GoToRemoteAction | Να πλοηγηθείτε σε μια σελίδα σε ένα εξωτερικό PDF |
LaunchAction | Ανοίξτε ένα εξωτερικό αρχείο |
NamedAction | Τριγκερ μια προκαθορισμένη εντολή θεατή |
PdfAction.CreateGoTo | Φάκτρα για δράσεις GoTo |
PdfAction.CreateNamed | Φάκτρα για ονομαστικές δράσεις |
ActionCollection | Συλλογή δράσεων σε μια σελίδα ή αναφορά |
DestinationCollection | Ονομαστικό μητρώο προορισμού |
ActionType | Ενότητα: GoTo, URI, JavaScript, Ονομαστικό, Ξεκινάω |