SetTableHeaderRowCount

Tabele

Opis

Podaje liczbę początkowych wierszy tabeli będących nagłówkami

Składnia

Delphi

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

Parametry

TableID	Tabela zwrócona przez CreateTable
HeaderRowCount	Liczba górnych wierszy będących nagłówkami. `0` oznacza brak nagłówków

Wartości zwracane

1	Liczba została przyjęta
0	Tabela była nieznana albo liczba była ujemna lub przekraczała ostatni wiersz; niczego nie zmieniono

Uwagi

Wiersze nagłówków są zapisywane jako komórki nagłówków z zakresem kolumny. Dzięki temu czytnik może podać nazwę nagłówka bieżącej wartości zamiast odczytywać samą liczbę bez kontekstu

Tylko kod wywołujący wie, które wiersze są nagłówkami, dlatego tabela bez takiej informacji jest zapisywana wyłącznie z komórkami danych zamiast zgadywać: błędnie wskazany nagłówek byłby powtarzany przy każdej wartości pod nim

Liczba jest używana podczas rysowania tabeli z włączonym tagowaniem tabel (zobacz SetAutoTagMode) oraz przez DrawTaggedTableRows. Określa wyłącznie nagłówki; ich powtarzanie u góry każdej strony jest osobną decyzją układu podejmowaną za pomocą DrawTaggedTableRows. Poszczególnym komórkom nadal można przypisać własny typ przez SetTableCellTag, który ma pierwszeństwo

Przykład

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

Zobacz również

GetTableHeaderRowCount, SetTableCellTag, DrawTaggedTableRows, SetAutoTagMode