SetStructElemColor

PDF balisé, accessibilité

Description

Définit l’attribut /Color (propriétaire d’attribut Layout) sur l’élément de structure actuellement ouvert dans la pile de balises. La valeur indique la couleur de premier plan (texte ou contour) du contenu de l’élément sous forme de triplet RGB. Équivaut à appeler AddTagAttribute avec Owner=Layout, Name=Color et une chaîne R G B séparée par des espaces

Syntaxe

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);

Paramètres

R	Composante rouge de la couleur, comprise entre 0,0 (aucun rouge) et 1,0 (rouge complet)
G	Composante verte de la couleur, comprise entre 0,0 et 1,0
B	Composante bleue de la couleur, comprise entre 0,0 et 1,0

Valeur de retour

Renvoie 1 en cas de réussite Renvoie 0 si aucun document n'est ouvert ou si aucune balise n'est actuellement ouverte sur la pile de balises

Remarques

Appelez cette fonction après BeginTag ou BeginTagEx et avant EndTag. L’attribut /Color est défini dans ISO 32000-1 §14.8.5.4.2 (propriétaire Layout, tableau 340) et stocké comme tableau PDF de trois nombres

Cet attribut décrit la couleur de premier plan perçue par une technologie d’assistance ou un moteur de redistribution. Il est indicatif ; la couleur visuelle dépend de l’état graphique. Une information exacte permet toutefois de contrôler les rapports de contraste WCAG 2.x 1.4.3 et de préserver la fidélité lors de la redistribution

Valeurs de couleur courantes : noir = (0.0, 0.0, 0.0) ; blanc = (1.0, 1.0, 1.0) ; rouge = (1.0, 0.0, 0.0)

Exemple

// 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;

Voir aussi

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag