AddSquareAnnotation

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

Περιγραφή

Προσθέτει ορθογώνιο σχολιασμό (PDF /Subtype /Square) στην επιλεγμένη σελίδα. Ο σχολιασμός σχεδιάζει ορθογώνιο με περίγραμμα εγγεγραμμένο στο δοθέν ορθογώνιο οριοθέτησης και μπορεί προαιρετικά να γεμίσει με συμπαγές χρώμα εσωτερικού. Οι συνιστώσες χρώματος και η αδιαφάνεια εκφράζονται σε κλίμακα 0–1· η Transparency σε κλίμακα 0–100 (0 = πλήρως αδιαφανές, 100 = πλήρως διαφανές). Επειδή το σημείο εισόδου γράφει το κλειδί αδιαφάνειας /CA του PDF 1.4, η βιβλιοθήκη ανεβάζει τα ξεκλείδωτα χαμηλότερα έγγραφα σε PDF 1.4 πριν την αποθήκευση· κλειδωμένοι χαμηλότεροι στόχοι απορρίπτονται από την πύλη συμβατότητας. Ορίζεται στο ISO 32000-1 §12.5.6.8.

Σύνταξη

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Παράμετροι

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

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

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

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

BorderWidth — Πλάτος πένας του περιγράμματος του ορθογωνίου, στις τρέχουσες μονάδες. Γράφεται τόσο στο legacy πεδίο /Border όσο και στο λεξικό στυλ περιγράμματος /BS

BorderRed, BorderGreen, BorderBlue — RGB συνιστώσες (0–1) του χρώματος περιγράμματος, που γράφονται στο /C

Filled — 1 για έκδοση εσωτερικού χρώματος γεμίσματος (/IC), 0 για να μείνει το ορθογώνιο χωρίς γέμισμα

FillRed, FillGreen, FillBlue — RGB συνιστώσες (0–1) του χρώματος εσωτερικού γεμίσματος. Αγνοούνται όταν το Filled είναι 0

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

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

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

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

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

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

Το σχόλιο εκδίδεται με τυπικό σύνολο πεδίων markup: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (όταν Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Αυτό ταιριάζει με ό,τι παράγουν τα Adobe Acrobat και Foxit για τα εργαλεία επισκόπησης ορθογωνίων τους, ώστε εξωτερικές ροές εργασίας επισκόπησης να μπορούν να εντοπίσουν, να επεξεργαστούν, να σχολιάσουν και να απαντήσουν στο προκύπτον σχόλιο

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