SetStructElemColor

PDF με ετικέτες, Προσβασιμότητα

Περιγραφή

Ορίζει το χαρακτηριστικό /Color (ιδιοκτήτης χαρακτηριστικών διάταξης) στο στοιχείο δομής που είναι ανοικτό αυτή τη στιγμή στη στοίβα ετικετών. Η τιμή καθορίζει το χρώμα προσκηνίου (κειμένου ή περιγράμματος) του περιεχομένου του στοιχείου ως τριάδα RGB. Ισοδυναμεί με κλήση του AddTagAttribute με Owner=Layout, Name=Color και συμβολοσειρά R G B χωρισμένη με κενά

Σύνταξη

Delphi

Function TPDFlib.SetStructElemColor(R, G, B: Double): Integer;

ActiveX

Function PDFlib::SetStructElemColor(R As Double, G As Double, B As Double) As Long

DLL

int DLSetStructElemColor(int InstanceID, double R, double G, double B);

Παράμετροι

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

Επιστρέφει 1 σε περίπτωση επιτυχίας. Επιστρέφει 0 αν δεν έχει ανοίξει έγγραφο ή αν δεν υπάρχει ανοικτή ετικέτα στη στοίβα ετικετών

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

Καλέστε αυτή τη συνάρτηση μετά το BeginTag ή BeginTagEx και πριν το EndTag. Η ιδιότητα /Color ορίζεται στο ISO 32000-1 §14.8.5.4.2 (ιδιοκτήτης ιδιοτήτων Layout, Table 340) και αποθηκεύεται ως PDF array τριών αριθμών

Αυτό το attribute περιγράφει το χρώμα foreground του στοιχείου όπως το αντιλαμβάνεται μια assistive technology ή μηχανή re-flow. Είναι συμβουλευτικό — το οπτικό χρώμα που αποδίδεται στο PDF ελέγχεται από την κατάσταση graphics, όχι από αυτό το attribute. Ωστόσο η παροχή ακριβών πληροφοριών χρώματος επιτρέπει σε downstream εργαλεία να ελέγχουν λόγους αντίθεσης χρωμάτων (WCAG 2.x Success Criterion 1.4.3) και να διατηρούν πιστότητα κατά την αναδίπλωση περιεχομένου

Συνηθισμένες τιμές χρώματος: black = (0.0, 0.0, 0.0)· white = (1.0, 1.0, 1.0)· red = (1.0, 0.0, 0.0)

Παράδειγμα

// Tag a heading rendered in dark blue
PDFlib.BeginTag('H2', '', '', '');
PDFlib.SetStructElemColor(0.0, 0.18, 0.39);  // RGB for dark blue
PDFlib.DrawText('Section 2', 72, 700);
PDFlib.EndTag;

Δείτε επίσης

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag