SetStructElemColor

PDF marcado, Acessibilidade

Descrição

Define o atributo /Color (proprietário de atributo Layout) no elemento de estrutura aberto no momento na pilha de tags O valor especifica a cor de primeiro plano (texto ou traço) do conteúdo do elemento como uma trinca RGB Equivale a chamar AddTagAttribute com Owner=Layout, Name=Color e uma string R G B separada por espaços

Sintaxe

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 vermelho da cor, na faixa de 0.0 (sem vermelho) a 1.0 (vermelho total).
G	Componente verde da cor, na faixa de 0.0 a 1.0.
B	Componente azul da cor, na faixa de 0.0 a 1.0.

Valor de retorno

Retorna 1 em caso de sucesso. Retorna 0 se nenhum documento estiver aberto ou nenhuma tag estiver aberta na pilha de tags

Observações

Chame esta função depois de BeginTag ou BeginTagEx e antes de EndTag. O atributo /Color é definido na ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, Tabela 340) e é armazenado como um array PDF de três números.

Este atributo descreve a cor de primeiro plano do elemento conforme percebida por uma tecnologia assistiva ou motor de reflow. É informativo — a cor visual renderizada no PDF é controlada pelo estado gráfico, não por este atributo. Ainda assim, fornecer informação de cor precisa permite que ferramentas a jusante verifiquem razões de contraste de cor (WCAG 2.x Success Criterion 1.4.3) e preservem a fidelidade ao refluir o conteúdo.

Common color values: black = (0.0, 0.0, 0.0); white = (1.0, 1.0, 1.0); red = (1.0, 0.0, 0.0).

Exemplo

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

Veja também

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag