SetStructElemColSpan

PDF etiquetado, acessibilidade

Descrição

Define o atributo /ColSpan (proprietário do atributo Table) no elemento de estrutura atualmente aberto na pilha de etiquetas. O valor indica quantas colunas são abrangidas pela célula de tabela atual. Equivale a chamar AddTagAttribute com Owner=Table, Name=ColSpan e o valor inteiro como cadeia

Sintaxe

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parâmetros

ColSpan	O número de colunas abrangidas pela célula atual da tabela. Tem de ser um número inteiro positivo. Um valor de 1 significa que a célula ocupa exatamente uma coluna (comportamento predefinido quando ColSpan não está definido). Valores superiores a 1 indicam uma célula de cabeçalho ou dados que abrange várias colunas

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 (com o tipo de etiqueta TH ou TD) e antes de EndTag. O atributo /ColSpan é definido na norma ISO 32000-1 §14.8.5.7.2 (proprietário do atributo Table, Tabela 337)

As células abrangentes são comuns em tabelas complexas — por exemplo, um cabeçalho de coluna que abrange duas colunas de dados. Fornecer o atributo /ColSpan permite que a tecnologia de apoio calcule corretamente as posições das células e associe os cabeçalhos às células de dados em toda a grelha da tabela

Quando uma célula também abrange várias linhas, utilize SetStructElemRowSpan em conjunto com esta função

Exemplo

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Consulte também

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag