AddPolyLineAnnotation

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

Περιγραφή

Προσθέτει σχολιασμό ανοικτής πολυγραμμής (PDF /Subtype /PolyLine) στην επιλεγμένη σελίδα με τη δοθείσα λίστα κορυφών. Η πολυγραμμή είναι ανοικτή — οι readers δεν ενώνουν την τελευταία κορυφή με την πρώτη — και μπορεί να έχει διαφορετικά στυλ άκρης στα δύο τελικά σημεία. Τα άκρα με εσωτερικό (ClosedArrow, Square, Circle, Diamond) μπορούν προαιρετικά να γεμίσουν. Οι συνιστώσες χρώματος και η αδιαφάνεια εκφράζονται σε κλίμακα 0–1· η Transparency σε κλίμακα 0–100 (0 = πλήρως αδιαφανές, 100 = πλήρως διαφανές). Η βιβλιοθήκη ανεβάζει την έκδοση του εγγράφου σε PDF 1.5 όταν εκδίδεται σχολιασμός PolyLine κάτω από κλείδωμα χαμηλότερης ελάχιστης έκδοσης. Ορίζεται στο ISO 32000-1 §12.5.6.9.

Σύνταξη

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Παράμετροι

VertexCoords — Συντεταγμένες κορυφών ως μία συμβολοσειρά εναλλασσόμενων τιμών x/y διαχωρισμένων με κενά, κόμματα, άνω-κάτω τελείες ή tabs. Παράδειγμα: το "100 100 200 150 300 100" ορίζει σχήμα V. Απαιτούνται τουλάχιστον δύο ζεύγη (τέσσερις αριθμοί) και άρτι συνολικό πλήθος αριθμών, αλλιώς η κλήση επιστρέφει 0.

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

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

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

Προαιρετικά προχωρημένα πεδία που περιγράφει η προδιαγραφή PDF — /IT (intent, συμπεριλαμβανομένου του PolyLineDimension) και /Measure — δεν εκδίδονται από αυτό το σημείο εισόδου. Μπορούν να προσαρθούν μετά τη δημιουργία γράφοντάς τα απευθείας στο λεξικό σχολίου

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