SetTableHeaderRowCount

Tabelas

Descrição

Indica quantas linhas iniciais de uma tabela são cabeçalhos

Sintaxe

Delphi

Function TPDFlib.SetTableHeaderRowCount(TableID, HeaderRowCount: Integer): Integer;

Parâmetros

TableIDA tabela, conforme devolvida por CreateTable
HeaderRowCountQuantas linhas a partir do topo são cabeçalhos. 0 significa nenhuma

Valores devolvidos

1A contagem foi efetuada
0A tabela era desconhecida ou o número era negativo ou posterior à última linha; nada foi alterado

Observações

As linhas de cabeçalho são escritas como células de cabeçalho com âmbito de coluna. É isto que permite a um leitor indicar o cabeçalho do valor em que se encontra, em vez de ler um número isolado sem qualquer referência

Só o chamador sabe quais são as linhas de cabeçalho, pelo que uma tabela que nada indica é escrita apenas com células de dados, em vez de se fazer uma suposição: um cabeçalho incorretamente identificado é repetido para todos os valores abaixo dele

A contagem é utilizada quando a tabela é desenhada com etiquetagem de tabelas ativa (consulte SetAutoTagMode) e por DrawTaggedTableRows. Apenas designa cabeçalhos; repeti-los no topo de cada página é uma decisão de disposição separada tomada com DrawTaggedTableRows. As células individuais podem continuar a receber um tipo próprio com SetTableCellTag, que tem precedência

Exemplo

PDF.SetAutoTagMode(AUTOTAG_DEFAULT);
Table := PDF.CreateTable(4, 3);
PDF.SetTableHeaderRowCount(Table, 1);   // the first row names the columns
PDF.DrawTableRows(Table, 50, 780, 240, 1, 0);

Consulte também

GetTableHeaderRowCount, SetTableCellTag, DrawTaggedTableRows, SetAutoTagMode