SetTableHeaderRowCount

Таблицы

Описание

Says how many leading rows of a table are headers.

Синтаксис

Delphi

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

Параметры

TableIDТаблица, возвращённая CreateTable
HeaderRowCountСколько строк сверху являются заголовками. 0 — ни одной

Возвращаемые значения

1The count was taken.
0Таблица неизвестна, счётчик отрицателен или за последней строкой; ничего не изменено

Примечания

Строки заголовков пишутся ячейками заголовков с областью действия по столбцу; именно поэтому читалка может назвать заголовок значения, на котором стоит, вместо того чтобы озвучить голое число без привязки

Какие строки — заголовки, знает только вызывающий код, поэтому молчащая таблица записывается всеми ячейками данных, а не угадывается: неверно названный заголовок повторится напротив каждого значения под ним

Счетчик используется, когда таблица рисуется с включенным тегированием таблиц (см. SetAutoTagMode), и в DrawTaggedTableRows. Он только называет заголовки; повторение их вверху каждой страницы — отдельное решение разметки, принимаемое в DrawTaggedTableRows. Отдельным ячейкам можно задать собственный тип через SetTableCellTag, который имеет приоритет

Пример

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

См. также

GetTableHeaderRowCount, SetTableCellTag, DrawTaggedTableRows, SetAutoTagMode