SetStructElemRowSpan

PDF marcado, Acessibilidade

Descrição

Define o atributo /RowSpan (owner de atributos Table) no elemento de estrutura aberto no topo da pilha de tags. O valor indica quantas linhas a célula de tabela atual atravessa. Equivale a chamar AddTagAttribute com Owner=Table, Name=RowSpan e o valor inteiro como string.

Sintaxe

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parâmetros

RowSpan	O número de linhas que a célula de tabela atual atravessa. Deve ser um inteiro positivo. O valor 1 significa que a célula ocupa exatamente uma linha (comportamento padrão quando nenhum RowSpan está definido). Valores maiores que 1 indicam uma célula que atravessa várias linhas.

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 (com tipo de tag TH ou TD) e antes de EndTag. O atributo /RowSpan é definido na ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Tabela 337).

Células mescladas verticalmente aparecem em tabelas onde uma célula de cabeçalho ou de dados precisa se estender por várias linhas — por exemplo, um cabeçalho de linha compartilhado por várias linhas de dados. Fornecer o atributo /RowSpan permite que a tecnologia assistiva construa corretamente o modelo lógico de grade da tabela.

Quando uma célula também atravessa várias colunas, use SetStructElemColSpan em combinação com esta função.

Exemplo

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

Veja também

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag