Annotations
Σχόλια
Αυτή η σελίδα καλύπτει τη δημιουργία, ανάγνωση, αναζήτηση και εξομάλυνση των PDF annotations. Page αποκαλύπτει μία Add*() μέθοδο ανά υποτύπο σχολίου, η κάθε μία επιστρέφει έναν ζωντανό Annotation χειριστή· η βασική κλάση Annotation και οι υποτύποι της (TextAnnotation, StampAnnotation, MarkupAnnotation και άλλοι) εκθέτουν τις ιδιότητες του σχολίου για ανάγνωση και επεξεργασία.
Δημιουργία Αναγνωρισμάτων Μορφοποίησης, Σημείωσης και Συνδέσμου
Οι τέσσερις μέθοδοι μορφοποίησης κειμένου — Page.AddHighlight(), Page.AddUnderline(), Page.AddSquiggly() και Page.AddStrikeOut() — λαμβάνουν έναν πίνακα quads (/QuadPoints) και επιστρέφουν ένα MarkupAnnotation. Page.AddLink() δημιουργεί μια κλικ-πρόσκληση περιοχή με URI ή εσωτερική ενέργεια, και Page.AddTextNote() προσθέτει ένα εικονίδιο σημείωσης που ανοίγει ένα αναδυόμενο παράθυρο με κείμενο contents, επιστρέφοντας ένα TextAnnotation.
page.AddHighlight({ quads, color: [1, 1, 0], contents: 'Yellow highlight' });
page.AddUnderline({ quads, color: [0, 0, 1] });
page.AddStrikeOut({ quads, color: [1, 0, 0] });
page.AddLink({
rect: [100, 700, 220, 716],
action: { type: 'uri', uri: 'https://example.com' },
border: 0,
});
page.AddTextNote({
rect: [x, y, x + 20, y + 20], icon: 'Note', author: 'Reviewer',
contents: 'This is a sticky-note annotation.',
});Page εκθέτει επίσης μεθόδους σχήματος και ελεύθερης σχεδίασης — AddSquare(), AddCircle(), AddLine(), AddPolygon(), AddPolyline(), AddInk(), AddFreeText(), AddCaret() και AddStamp() — η κάθε μία επιστρέφει το αντίστοιχο χειριστή αναγνώρισης για εκείνο τον υποτύπο, δημιουργώντας αυτόματα την εμφάνιση /AP του.
Ανάγνωση και Καταγραφή Αναγνωρισμάτων
page.Annotations είναι ένας πίνακας με κάθε Annotation στη σελίδα. Κάθε αναγνώρισμα, ανεξαρτήτως υποτύπου, εκθέτει τα Subtype, Rect, Color, Contents, Name, Layer, ModDate, Flags, Print, Hidden και Opacity; οι υποτύποι προσθέτουν τα δικά τους πεδία, όπως StampAnnotation.StampName ή MarkupAnnotation.QuadPoints.
const freeText = page.Annotations.find((a) => a.Subtype === 'FreeText');
if (freeText) {
freeText.Contents = 'Updated note text';
}Αναζήτηση Κειμένου Σημείωσης
Page.SearchAnnotationText() and Page.SearchAnnotations() είναι σκόπιμα διαχωρισμένα. SearchAnnotationText() βρίσκει αντιστοιχίες στο κείμενο μια σημείωση carries αντί να σχεδιάζει — μιας σημείωσης /Contents, του συγγραφέα (/T), ή του θέματος (/Subj) — και επιστρέφει AnnotationTextMatch[] ({ annot, key, value, text }). SearchAnnotations() βρίσκει αντιστοιχίες στο κείμενο μια σημείωση draws, όπως ένα FreeTextτις ορατές λέξεις, και επιστρέφει AnnotationMatch[] ({ annot, text, quads }).
// A sticky note's /Contents text — found by SearchAnnotationText, not SearchAnnotations.
const textHits = page.SearchAnnotationText('body secret');
console.log(textHits[0].key, textHits[0].value); // 'Contents' 'body secret'
// A FreeText's rendered words — found by SearchAnnotations, not SearchAnnotationText.
const drawnHits = page.SearchAnnotations('bravo');Ισοπέδωση Σημειώσεων
Annotation.Flatten() ενσωματώνει την εμφάνιση του /AP μιας σημείωσης απευθείας στο ρεύμα περιεχομένου της σελίδας στο /Rect, μετά το αφαιρεί από το /Annots. Το αποτέλεσμα είναι μόνιμο, στατικό περιεχόμενο — δεν αποτελεί πλέον ξεχωριστή σημείωση που ένας θεατής μπορεί να κάνει κλικ, να επεξεργαστεί ή να κρύψει.
const note = page.AddTextNote({
rect: [72, 660, 92, 680], icon: 'Comment', contents: 'Reviewed and approved.',
});
note.Flatten();Συμβουλές και Καλές Πρακτικές
- Καλέστε το
Flatten()στο αντικείμενο που επιστρέφεται άμεσα από την κλήσηAdd*()— μια σημείωση που λαμβάνεται με την επαναανάγνωση τουpage.Annotationsαργότερα είναι διαφορετική αναφορά αντικειμένου. SearchAnnotationText()καιSearchAnnotations()καλύπτουν διαφορετικό κείμενο: εκτελέστε και τα δύο εάν χρειάζεται να βρείτε μια φράση ανεξαρτήτως του αν πληκτρολογήθηκε σε μια σημείωση ή σχεδιάστηκε στη σελίδα.- Οι τέσσερις μέθοδοι σήμανσης (
AddHighlight,AddUnderline,AddSquiggly,AddStrikeOut) δημιουργούν αυτόματα την εμφάνιση/AP— δεν απαιτείται χειροκίνητη σχεδίαση στο ρεύμα περιεχομένου. - Η κρυπτογράφηση επιβιώνει σε έναν κύκλο: οι σημειώσεις που προστέθηκαν πριν από το
Document.Save()με μια επιλογήencryptπαραμένουν έγκυρες αφού το έγγραφο ανοίξει ξανά και αποκρυπτογραφηθεί.
Συνηθισμένα προβλήματα
| Πρόβλημα | Αιτία | Διόρθωση |
|---|---|---|
page.Annotations.find() επιστρέφει undefined για μια σημείωση που μόλις προσθέσατε | Αναζήτηση σε παρωχημένο πίνακα που καταγράφηκε πριν προστεθεί η σημείωση | Διαβάστε ξανά το page.Annotations μετά την κλήση Add*(), ή χρησιμοποιήστε απευθείας τη λαβή που επέστρεψε η κλήση |
SearchAnnotationText() δεν βρίσκει τίποτα για το κείμενο που είναι ορατό στη σελίδα | Το κείμενο σχεδιάζεται από τη σημείωση (π.χ. το σώμα ενός FreeText), όχι αποθηκευμένο στο /Contents | Χρησιμοποιήστε το SearchAnnotations() αντ’ αυτού — ταιριάζει με το σχεδιασμένο κείμενο |
Η σημείωση συνεχίζει να φαίνεται επεξεργάσιμη μετά το Flatten() | Το Flatten() κλήθηκε σε αντίγραφο αντί για το χειριστήριο που επέστρεψε το Add*() | Καλέστε το Flatten() στο αντικείμενο που επιστρέφεται άμεσα από τη μέθοδο δημιουργίας |
FAQ
Ποια είναι η διαφορά μεταξύ SearchAnnotationText και SearchAnnotations;
SearchAnnotationText() ταιριάζει κείμενο μιας σημείωσης carries — /Contents, /T (συγγραφέας), ή /Subj — όπως το σώμα μιας αυτοκόλλητης σημείωσης. SearchAnnotations() ταιριάζει κείμενο σε μια σημείωση draws στη σελίδα, όπως ένα FreeText’s ορατές λέξεις. Τα δύο είναι διακριτά: μια αντιστοίχιση στο ένα δεν θα εμφανιστεί στο άλλο.
Πώς μπορώ να κάνω μια σημείωση μόνιμη και μη διαδραστική;
Καλέστε το Flatten() στο χειριστή Annotation που επιστράφηκε από τη μέθοδο Add*() που το δημιούργησε. Αυτό ενσωματώνει την εμφάνισή του στη ροή περιεχομένου της σελίδας και το αφαιρεί από το /Annots.
Ποιοι υποτύποι σημειώσεων υποστηρίζονται;
Page εκθέτει μεθόδους δημιουργίας για σήμανση κειμένου (AddHighlight, AddUnderline, AddSquiggly, AddStrikeOut), σημειώσεις και κλήσεις (AddTextNote, AddFreeText, AddCaret), συνδέσμους (AddLink), σχήματα (AddSquare, AddCircle, AddLine, AddPolygon, AddPolyline), ελεύθερη μελάνη (AddInk), σφραγίδες (AddStamp), και συνημμένα αρχείων (AddFileAttachment).
Πώς μπορώ να απαριθμήσω κάθε σημείωση που υπάρχει ήδη σε μια σελίδα;
Διαβάστε το page.Annotations, έναν πίνακα από χειριστές Annotation. Κάθε ένας εκθέτει Subtype, Rect, Color, Contents, και τις άλλες κοινές ιδιότητες, ώστε να μπορείτε να τα φιλτράρετε ή να τα εξετάζετε με τις τυπικές μεθόδους πίνακα.
API Reference Περίληψη
| Κλάση/Μέθοδος | Περιγραφή |
|---|---|
Annotation | Βασική διαχείριση σε οποιαδήποτε σημείωση· εκθέτει Subtype, Rect, Color, Contents, Name, Flags, Print, Hidden, Opacity |
Annotation.Flatten() | Ενσωματώνει την εμφάνιση της σημείωσης στο στατικό περιεχόμενο της σελίδας |
TextAnnotation | Ένα /Text χειριστήριο αυτοκόλλητης σημείωσης; προσθέτει Icon, Open, Author |
StampAnnotation | Ένα /Stamp χειριστήριο σφραγίδας; προσθέτει StampName |
MarkupAnnotation | Ένα χειριστήριο σήμανσης κειμένου (Highlight/Underline/StrikeOut/Squiggly); προσθέτει MarkupType, QuadPoints |
Page.AddHighlight() / Page.AddUnderline() / Page.AddStrikeOut() / Page.AddSquiggly() | Δημιουργήστε μια σημείωση σήμανσης κειμένου πάνω από /QuadPoints |
Page.AddTextNote() | Δημιουργήστε μια αυτοκόλλητη σημείωση |
Page.AddLink() | Δημιουργήστε έναν κλικ-σύνδεσμο με URI ή εσωτερική ενέργεια |
Page.Annotations | Κάθε Annotation στη σελίδα, ως πίνακας |
Page.SearchAnnotationText() | Βρείτε το κείμενο που φέρει μια annotation (/Contents, /T, /Subj) |
Page.SearchAnnotations() | Βρείτε το κείμενο που σχεδιάζει μια annotation στη σελίδα |