AddPolygonAnnotation

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

Περιγραφή

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

Σύνταξη

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Παράμετροι

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

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

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

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

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

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

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