AddLineAnnotation

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

Περιγραφή

Προσθέτει ένα σχόλιο σήμανσης γραμμής (PDF /Subtype /Line) μεταξύ δύο σημείων τέλους στην επιλεγμένη σελίδα. Κάθε άκρο μπορεί να έχει διαφορετικό στυλ γραμμής-τερματισμού (βέλος, τετράγωνο, κύκλος, ρόμβος, …) και το σώμα της γραμμής μπορεί να σχεδιαστεί με οποιοδήποτε χρώμα RGB και ρυθμιζόμενη αδιαφάνεια. Οι διακοσμήσεις άκρων που έχουν εσωτερικό (ClosedArrow, Square, Circle, Diamond) μπορούν προαιρετικά να γεμιστούν. Επειδή αυτό το σημείο εισόδου εκπέμπει το κλειδί αδιαφάνειας /CA του σχολίου PDF 1.4, η βιβλιοθήκη αναβαθμίζει τα παλαιότερα μη κλειδωμένα έγγραφα σε PDF 1.4 πριν από την αποθήκευση· οι κλειδωμένοι παλαιότεροι στόχοι απορρίπτονται από τον μηχανισμό συμβατότητας. Ορίζεται στο ISO 32000-1 §12.5.6.7

Σύνταξη

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Παράμετροι

StartLeft, StartTop — Συντεταγμένες του σημείου αρχής της γραμμής, στις τρέχουσες μονάδες

EndLeft, EndTop — Συντεταγμένες του τελικού σημείου της γραμμής, στις τρέχουσες μονάδες

BorderWidth — Πλάτος πένας της γραμμής και των τελικών διακοσμήσεων της, στις τρέχουσες μονάδες

LineRed, LineGreen, LineBlue — RGB συνιστώσες (0–1) του χρώματος γραμμής, που γράφονται στο /C

StartStyle, EndStyle — Στυλ τελικής γραμμής για τα σημεία αρχής και τέλους αντίστοιχα. Χρησιμοποιήστε ένα από:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Τιμές εκτός εύρους περιορίζονται στο 0 (None)

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 αν δεν έχει επιλεγεί έγγραφο ή αν δεν μπόρεσε να δημιουργηθεί το σχόλιο

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

Το /Rect του σχολίου υπολογίζεται αυτόματα από τα δύο άκρα συν padding ανάλογο του πλάτους περιγράμματος ώστε οι τελικές διακοσμήσεις να μένουν μέσα στο bounding box του σχολίου. Οι PDF readers απαιτούν το οριακό /Rect να περιέχει όλο το ορατό σχέδιο αλλιώς οι τελικές διακοσμήσεις μπορεί να περικοπούν

Προαιρετικά προχωρημένα πεδία που περιγράφει η προδιαγραφή PDF — /LL (μήκος leader), /LLE, /LLO, /Cap, /CP, /CO και /Measure — δεν εκδίδονται από αυτό το σημείο εισόδου. Μπορούν να προσαρθούν μετά τη δημιουργία γράφοντάς τα απευθείας στο λεξικό σχολίου

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