AddCaretAnnotation

Σχολιάσεις και σύνδεσμοι hotspot

Περιγραφή

Προσθέτει σχολιασμό caret (PDF /Subtype /Caret) στην επιλεγμένη σελίδα. Ο σχολιασμός caret είναι ορατό σύμβολο που κατά σύμβαση σηματοδοτεί θέση στη σελίδα όπου έχει γίνει εισαγωγή ή παράλειψη κειμένου ή περιεχομένου, ή όπου χρειάζεται προσοχή του reviewer. Διαθέσιμα σχήματα: απλό caret (None) ή σημείο παραγράφου (Paragraph). Οι συνιστώσες χρώματος και η αδιαφάνεια εκφράζονται σε κλίμακα 0–1· η Transparency σε κλίμακα 0–100 (0 = πλήρως αδιαφανές, 100 = πλήρως διαφανές). Η βιβλιοθήκη ανεβάζει την έκδοση του εγγράφου σε PDF 1.5 όταν εκδίδεται σχολιασμός Caret κάτω από κλείδωμα χαμηλότερης ελάχιστης έκδοσης. Ορίζεται στο ISO 32000-1 §12.5.6.11.

Σύνταξη

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Παράμετροι

Left — Οριζόντια συντεταγμένη της κάτω αριστερής γωνίας του ορθογωνίου του σχολίου, στις τρέχουσες μονάδες

Top — Κατακόρυφη συντεταγμένη της κάτω αριστερής γωνίας του ορθογωνίου του σχολίου, στις τρέχουσες μονάδες

Width — Το πλάτος του ορθογωνίου του σχολίου

Height — Το ύψος του ορθογωνίου του σχολίου

SymbolType — Στυλ συμβόλου Caret:

0 = Καμία (απλό caret "^")

1 = Παράγραφος (pilcrow "¶")

Κάθε άλλη τιμή αντιμετωπίζεται ως 0 (None)

ColorRed, ColorGreen, ColorBlue — RGB συνιστώσες (0–1) του χρώματος caret, που γράφονται στο /C

Title — Όνομα συγγραφέα που γράφεται στην εγγραφή /T του σχολίου. Δώστε κενή συμβολοσειρά για παράλειψη

Contents — Το σώμα του popup που συνδέεται με το σχόλιο. Δώστε κενή συμβολοσειρά για παράλειψη

Transparency — Η αδιαφάνεια εκφρασμένη ως ποσοστό διαφάνειας (0–100). Η βιβλιοθήκη το μετατρέπει σε PDF /CA = 1 - Transparency/100 και το περιορίζει στο εύρος

Τιμή επιστροφής

1 σε επιτυχία, 0 αν δεν έχει επιλεγεί έγγραφο ή αν δεν μπόρεσε να δημιουργηθεί το σχόλιο

Παρατηρήσεις

Το σχόλιο εκδίδεται με /Type /Annot, /Subtype /Caret, /Rect, /Sy (το όνομα συμβόλου), /C, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret" και /P. Το προαιρετικό πεδίο /RD (μετατόπιση caret μέσα στο /Rect) δεν εκδίδεται· οι readers το προεπιλέγουν σε μηδενικά ώστε το caret να καταλαμβάνει όλο το ορθογώνιο του σχολίου

Για να αντικαταστήσετε το ορθογώνιο, το χρώμα ή το περιεχόμενο του σχολίου μετά τη δημιουργία του, χρησιμοποιήστε τα SetAnnotRect, SetAnnotBorderColor και SetAnnotContents