SetStructElemColor

PDF etiquetado, Accesibilidad

Descripción

Establece el atributo /Color (propietario de atributo Layout) en el elemento de estructura abierto actualmente en la pila de etiquetas. El valor especifica el color de primer plano (texto o trazo) del contenido del elemento como una terna RGB. Equivale a llamar a AddTagAttribute con Owner=Layout, Name=Color y una cadena R G B separada por espacios

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

Valor devuelto

Devuelve 1 si tiene éxito Devuelve 0 si no hay un documento abierto o si no hay ninguna etiqueta abierta actualmente 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, Tabla 340) y se almacena como una matriz PDF de tres elementos numéricos

Este atributo describe el color de primer plano del elemento según lo percibe una tecnología de asistencia o un motor de redistribución Es informativo: el color visual representado en el PDF se controla mediante el estado gráfico, no mediante este atributo Sin embargo, proporcionar información de color precisa permite a las herramientas posteriores comprobar las proporciones de contraste de color (WCAG 2.x Success Criterion 1.4.3) y mantener la fidelidad al redistribuir el contenido

Valores de color comunes: 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