SetTableHeaderRowCount

表格

描述

說明表格開頭有幾列是表頭

語法

Delphi

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

參數

TableID表格,由 CreateTable 傳回。
HeaderRowCount從頂部算起有幾列是表頭。0 表示沒有。

傳回值

1The count was taken.
0表格不明,或計數為負值或超過最後一列;未做任何變更。

備註

表頭列會寫成帶欄位範圍(column scope)的表頭儲存格,閱讀器因此能說出某個值隸屬哪個標題,而不是朗讀一個沒有任何歸屬的裸數字

哪些列是表頭只有呼叫端知道,因此沒有任何表頭資訊的表格會整個寫成資料儲存格而不是用猜的:表頭標錯時,它會被套到其下每一個值上。

表格在開啟表格標記的情況下繪製時(見 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