SetStructElemColor

PDF etiquetado, Accesibilidad

Descripción

Establece /Color en el elemento actual como triplete RGB. Equivale a AddTagAttribute con Owner=Layout, Name=Color y cadena R G B

Sintaxis

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

Parámetros

R	Componente rojo del color, en el intervalo de 0.0 (sin rojo) a 1.0 (rojo completo)
G	Componente verde del color, en el intervalo de 0.0 a 1.0
B	Componente azul del color, en el intervalo de 0,0 a 1,0

Valor devuelto

Devuelve 1 si se ejecuta correctamente. Devuelve 0 si no hay ningún documento abierto o ninguna etiqueta abierta en la pila de etiquetas

Observaciones

Llame a esta función después de BeginTag o BeginTagEx y antes de EndTag. El atributo /Color se define en ISO 32000-1 §14.8.5.4.2 (propietario del atributo Layout, Table 340) y se almacena como una matriz PDF de tres números

Este atributo describe el color de primer plano del elemento tal como lo perciben una tecnología de asistencia o un motor de redistribución. Es orientativo: el color visual renderizado en el PDF está controlado por el estado gráfico, no por este atributo. Sin embargo, proporcionar información de color precisa permite a las herramientas posteriores comprobar las relaciones de contraste de color (criterio de conformidad 1.4.3 de WCAG 2.x) y mantener la fidelidad al redistribuir el contenido

Valores de color habituales: negro = (0.0, 0.0, 0.0); blanco = (1.0, 1.0, 1.0); rojo = (1.0, 0.0, 0.0)

Ejemplo

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

Véase también

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag