SetStructElemColor

PDF etiquetado, acessibilidade

Descrição

Define o atributo /Color (proprietário do atributo Layout) no elemento de estrutura atualmente aberto na pilha de etiquetas. O valor especifica a cor de primeiro plano (texto ou contorno) do conteúdo do elemento como um triplo RGB. Equivale a chamar AddTagAttribute com Owner=Layout, Name=Color e uma cadeia 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

Valor devolvido

Devolve 1 em caso de êxito. Devolve 0 se não houver nenhum documento aberto ou nenhuma etiqueta atualmente aberta na pilha de etiquetas

Observações

Chame esta função depois de BeginTag ou BeginTagEx e antes de EndTag. O atributo /Color é definido na norma ISO 32000-1 §14.8.5.4.2 (proprietário do atributo Layout, Tabela 340) e é armazenado como uma matriz PDF de três números

Este atributo descreve a cor de primeiro plano do elemento tal como percecionada por uma tecnologia de apoio ou motor de refluxo. É consultivo — a cor visual composta no PDF é controlada pelo estado gráfico, não por este atributo. Contudo, o fornecimento de informações de cor exatas permite que as ferramentas a jusante verifiquem as relações de contraste de cores (Critério de Sucesso 1.4.3 das WCAG 2.x) e mantenham a fidelidade ao refluir o conteúdo

Valores de cor comuns: preto = (0.0, 0.0, 0.0); branco = (1.0, 1.0, 1.0); vermelho = (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;

Consulte também

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag