SetStructElemRowSpan

標籤式 PDF、無障礙

描述

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

語法

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

參數

RowSpan	目前表格儲存格縱跨的列數。必須是正整數。值為 1 表示儲存格正好佔一列（未設 RowSpan 時的預設行為）。大於 1 表示跨列的儲存格。

傳回值

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

備註

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

需要跨列合併的儲存格出現在表頭或資料儲存格必須縱向延伸多列的表格 — 例如多個資料列共用的列表頭。提供 /RowSpan 屬性可讓輔助技術正確建立表格的邏輯網格模型。

儲存格同時橫跨多欄時，請把 SetStructElemColSpan 與本函式搭配使用。

範例

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

另見

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag