SetTableHeaderRowCount
Tabellen
Beschreibung
Gibt an, wie viele führende Zeilen einer Tabelle Kopfzeilen sind.
Syntax
Delphi
Function TPDFlib.SetTableHeaderRowCount(TableID, HeaderRowCount: Integer): Integer;Parameter
| TableID | Die Tabelle, wie sie von CreateTable zurückgegeben wird |
|---|---|
| HeaderRowCount | Wie viele Zeilen von oben als Kopfzeilen dienen. 0 bedeutet keine |
Rückgabewerte
| 1 | Die Anzahl wurde ermittelt. |
|---|---|
| 0 | Die Tabelle war unbekannt, oder die Anzahl war negativ beziehungsweise lag hinter der letzten Zeile; es wurde nichts geändert |
Anmerkungen
Kopfzeilen werden als Kopfzellen mit Spaltengültigkeitsbereich geschrieben. Dadurch kann ein Reader die Überschrift des aktuellen Werts benennen, statt eine bloße Zahl ohne Bezug vorzulesen.
Nur der Aufrufer weiß, welche Zeilen Kopfzeilen sind. Eine Tabelle ohne entsprechende Angabe wird daher vollständig mit Datenzellen geschrieben, statt zu raten: Eine falsch benannte Überschrift wird bei jedem darunterliegenden Wert wiederholt.
Die Anzahl wird verwendet, wenn die Tabelle mit aktivierter Tabellen-Tag-Struktur gezeichnet wird, siehe SetAutoTagMode, sowie von DrawTaggedTableRows. Sie benennt nur Kopfzeilen; ihre Wiederholung am Anfang jeder Seite ist eine getrennte Layoutentscheidung mit DrawTaggedTableRows. Einzelne Zellen können weiterhin über SetTableCellTag einen eigenen Typ erhalten, der Vorrang hat.
Beispiel
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);Siehe auch
GetTableHeaderRowCount, SetTableCellTag, DrawTaggedTableRows, SetAutoTagMode