SetStructElemColSpan

Tagged PDF, Accessibility

Description

Define o atributo /ColSpan (proprietário do atributo Table) no elemento de estrutura atualmente aberto na pilha de tags. O valor indica quantas colunas a célula da tabela atual abrange. Equivalente a chamar AddTagAttribute com Owner=Table, Name=ColSpan e o valor inteiro como uma string

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parameters

ColSpan	O número de colunas que a célula da tabela atual abrange; deve ser um número inteiro positivo; um valor de 1 significa que a célula ocupa exatamente uma coluna (comportamento padrão quando nenhum ColSpan é definido); valores maiores que 1 indicam um cabeçalho ou célula de dados abrangente

Return value

Retorna 1 em caso de sucesso; retorna 0 se nenhum documento estiver aberto ou nenhuma tag estiver aberta no momento na pilha de tags

Remarks

Chame esta função após BeginTag (com o tipo de tag 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 Tabela, Tabela 337)

Células de abrangência 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 assistiva calcule corretamente as posições das células e associe cabeçalhos com células de dados em toda a grade da tabela

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

Example

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