SetStructElemColSpan

標籤式 PDF、無障礙

描述

在標籤堆疊目前開啟的結構元素上設定 /ColSpan 屬性（Table 屬性擁有者）。值表示目前表格儲存格橫跨幾欄。等同呼叫 AddTagAttribute，參數 Owner=Table、Name=ColSpan，值為整數字串。

語法

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

參數

ColSpan	目前表格儲存格橫跨的欄數。必須是正整數。值為 1 表示儲存格正好佔一欄（未設 ColSpan 時的預設行為）。大於 1 表示跨欄的表頭或資料儲存格。

傳回值

成功傳回 1。沒有開啟的文件，或標籤堆疊上沒有開啟中的標籤時傳回 0

備註

請在 BeginTag（標籤類型為 TH 或 TD）之後、EndTag 之前呼叫此函式。/ColSpan 屬性定義於 ISO 32000-1 §14.8.5.7.2（Table attribute owner，表 337）。

合併儲存格在複雜表格中很常見 — 例如橫跨兩個資料欄的欄表頭。提供 /ColSpan 屬性可讓輔助技術正確計算儲存格位置，並在整個表格網格中把表頭與資料儲存格關聯起來。

儲存格同時縱跨多列時，請把 SetStructElemRowSpan 與本函式搭配使用。

範例

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

另見

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag