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 στη σελίδα

Δείτε επίσης

 Ελληνικά