Πώς να εργαστείτε με τις σημειώσεις PDF σε C++

Aspose.PDF FOSS για C++ αντιπροσωπεύει κάθε σημείωση PDF ως υποκατηγορία της κοινής βάσης Annotation, και εκθέτει τις σημειώσεις σε μια σελίδα μέσω του AnnotationCollection που επιστρέφεται από το Page::Annotations(). Αυτός ο οδηγός προσθέτει μια σημείωση κειμένου απλού κειμένου και μια στυλιζαρισμένη σημείωση σε μια σελίδα με TextAnnotation, αποθηκεύει το έγγραφο, και στη συνέχεια το ανοίγει ξανά για να διαβάσει τις σημειώσεις και να αφαιρέσει μία. Η βιβλιοθήκη ενσωματώνεται σε ένα έργο CMake ως εξάρτηση υποκαταλόγου — δεν υπάρχει βήμα εγκατάστασης μέσω καταχωρητή πακέτων.

Οδηγός βήμα-βήμα

add_subdirectory(aspose.pdf-foss-for-cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

#include <aspose/pdf/document.hpp>
#include <iostream>

int main() {
    Aspose::Pdf::Document doc;
    std::cout << "Linked OK — pages: " << doc.Pages().Count() << "\n";
}

#include <aspose/pdf/document.hpp>
#include <aspose/pdf/page_collection.hpp>
#include <aspose/pdf/rectangle.hpp>
#include <aspose/pdf/color.hpp>
#include <aspose/pdf/annotations/annotation.hpp>
#include <aspose/pdf/annotations/annotation_collection.hpp>
#include <aspose/pdf/annotations/annotation_type.hpp>
#include <aspose/pdf/annotations/annotation_flags.hpp>
#include <aspose/pdf/annotations/border.hpp>
#include <aspose/pdf/annotations/border_style.hpp>
#include <aspose/pdf/annotations/text_annotation.hpp>

using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Annotations;

Document doc;
Page page = doc.Pages().Add();

TextAnnotation note{doc};
note.Rect(Rectangle(100.0, 700.0, 200.0, 720.0, false));
note.Contents("Reviewed and approved.");

page.Annotations().Add(note);

TextAnnotation flagged{doc};
flagged.Rect(Rectangle(100.0, 600.0, 300.0, 650.0, false));
flagged.Contents("Needs follow-up");
flagged.Color(Color::FromRgb(220, 20, 20));
flagged.Flags(AnnotationFlags::Print | AnnotationFlags::ReadOnly);
flagged.Border().Width(2);
flagged.Border().Style(BorderStyle::Dashed);

page.Annotations().Add(flagged);

doc.Save("annotated.pdf");

Document reopened("annotated.pdf");
auto& annots = reopened.Pages()[1].Annotations();

std::cout << "Annotation count: " << annots.Count() << "\n";

for (int i = 0; i < annots.Count(); ++i) {
    const auto& a = annots[i];
    if (a.AnnotationType() == AnnotationType::Text) {
        std::cout << "Text annotation: " << a.Contents() << "\n";
    }
}

annots.Delete(0);
reopened.Save("annotated-cleaned.pdf");

Κοινά προβλήματα και διορθώσεις

Τίποτα δεν αλλάζει στο αποθηκευμένο PDF μετά την κλήση Annotations().Add()

Δύο πράγματα συνήθως πάει λάθος εδώ. Πρώτον, PageCollection είναι 1-βάση (doc.Pages()[1] είναι η πρώτη σελίδα) ενώ AnnotationCollection είναι 0-βάση (annots[0] είναι η πρώτη σημείωση) — η σύγχυση των δύο σχημάτων δεικτοδότησης οδηγεί σε λειτουργία στο λάθος αντικείμενο. Δεύτερον, βεβαιωθείτε ότι το Document::Save() εκτελείται πραγματικά μετά την προσθήκη της σημείωσης· τίποτα δεν γράφεται στο δίσκο μέχρι τότε.

AnnotationCollection ευρετηρίαση ή Delete(index) throws std::out_of_range

Οι έγκυροι δείκτες κυμαίνονται από το 0 έως το Count() - 1. Η παροχή ενός αρνητικού δείκτη ή ενός δείκτη ίσου ή μεγαλύτερου του Count() προκαλεί std::out_of_range επίτηδες. Καλέστε το Count() πρώτα για να περιορίσετε οποιονδήποτε βρόχο ή αναζήτηση.

Remove() returns false τη δεύτερη φορά που το καλώ στην ίδια σημείωση

Αυτό δεν είναι σφάλμα. Το Remove() αναφέρει αν η σημείωση βρέθηκε και αφαιρέθηκε ως bool; η επανεκτέλεση σε μια σημείωση που ήδη έχει αφαιρεθεί είναι πράξη χωρίς αποτέλεσμα που επιστρέφει false. Ελέγξτε την τιμή επιστροφής αντί να υποθέτετε ότι το Remove() επιτυγχάνει πάντα.

Ορισμός νέου AnnotationFlags η τιμή καθαρίζει τις σημαίες που είχα ήδη ορίσει

Flags(value) αντικαθιστά ολόκληρο το σύνολο σημαιών — δεν ενώνει με την προηγούμενη τιμή. Για να προσθέσετε ή να αφαιρέσετε μια μόνο σημαία, διαβάστε πρώτα τις τρέχουσες σημαίες και συνδυάστε τις με τελεστές bitwise, για παράδειγμα a.Flags(a.Flags() | AnnotationFlags::Print) για προσθήκη σημαίας, ή a.Flags(a.Flags() & ~AnnotationFlags::Print) για αφαίρεση μιας σημαίας ενώ αφήνετε τις υπόλοιπες ανέπαφες.

Συχνές Ερωτήσεις

Ποια είναι η σχέση μεταξύ Annotation, TextAnnotation και των άλλων υποτύπων annotation;

Annotation είναι η κοινή βασική κλάση. TextAnnotation και οι άλλοι συγκεκριμένοι τύποι annotation εξειδικεύουν αυτήν για ένα PDF annotation subtype, ενώ μοιράζονται τις μεθόδους πρόσβασης Rect(), Contents(), Color(), Flags() και Border() της βασικής κλάσης.

Οι annotations περιορίζονται σε ολόκληρο το έγγραφο ή σε μία σελίδα;

Κάθε σελίδα έχει το δικό της AnnotationCollection, το οποίο επιστρέφεται από τη μέθοδο Annotations() της σελίδας. Οι annotations είναι πάντα περιορισμένες στη σελίδα στην οποία προστέθηκαν, όχι σε όλο το έγγραφο.

Πώς μπορώ να μετρήσω πόσες annotations υπάρχουν σε μια σελίδα;

Καλέστε το Count() στο AnnotationCollection που επιστρέφεται από το Page::Annotations().

Μπορεί μια annotation να είναι ταυτόχρονα εκτυπώσιμη και μόνο για ανάγνωση;

Ναι. Το AnnotationFlags είναι πεδίο bit, έτσι συνδυάστε τιμές με λογικό OR, για παράδειγμα AnnotationFlags::Print | AnnotationFlags::ReadOnly.

Η διαγραφή μιας σημείωσης από το AnnotationCollection την αφαιρεί από το αρχείο PDF στο δίσκο;

Μόνο μετά την εκτέλεση του Document::Save(). Τα Delete(), Remove() και Clear() τροποποιούν μόνο τη συλλογή στη μνήμη — το PDF στο δίσκο παραμένει αμετάβλητο μέχρι να αποθηκευτεί το έγγραφο.

Δείτε επίσης

• Εργασία με PDF Annotations (Developer Guide)
• Οδηγός Εγκατάστασης
• API Reference
• Aspose.PDF FOSS for C++ — Σελίδα Προϊόντος
• Αποθετήριο GitHub
• Aspose.PDF for C++ — Enterprise Knowledge Base