SetStructElemRowSpan

Tagged PDF, Accessibility

Description

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

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parameters

RowSpan	O número de linhas 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 linha (comportamento padrão quando nenhum RowSpan é definido); valores maiores que 1 indicam uma célula que abrange várias linhas

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 /RowSpan é definido na norma ISO 32000-1 §14.8.5.7.2 (proprietário do atributo Tabela, Tabela 337)

Células que abrangem várias linhas aparecem em tabelas onde um cabeçalho ou célula de dados precisa se estender verticalmente 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 de grade lógica da tabela

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

Example

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