SetTableHeaderRowCount
表格
描述
說明表格開頭有幾列是表頭
語法
Delphi
Function TPDFlib.SetTableHeaderRowCount(TableID, HeaderRowCount: Integer): Integer;參數
| TableID | 表格,由 CreateTable 傳回。 |
|---|---|
| HeaderRowCount | 從頂部算起有幾列是表頭。0 表示沒有。 |
傳回值
| 1 | The 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