SetStructElemRowSpan

PDF etiquetado, acessibilidade

Descrição

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

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 abrangidas pela célula atual da tabela. Tem de ser um inteiro positivo. O valor 1 significa que a célula ocupa exatamente uma linha (comportamento predefinido quando RowSpan não está definido). Os valores superiores a 1 indicam uma célula que abrange várias linhas

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

As células que abrangem várias linhas surgem em tabelas onde uma célula de cabeçalho ou de dados tem de se estender verticalmente por várias linhas — por exemplo, um cabeçalho de linha partilhado por várias linhas de dados. O fornecimento do atributo /RowSpan permite que a tecnologia de apoio crie corretamente o modelo lógico da grelha da tabela

Quando uma célula também abrange várias colunas, utilize SetStructElemColSpan em conjunto 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;

Consulte também

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag