SetStructElemScope

標籤式 PDF、無障礙

描述

在標籤堆疊目前開啟的結構元素上設定 /Scope 屬性（Table attribute owner）。範圍用來識別 TH（表格表頭）儲存格適用於直欄、列還是兩者 — PDF/UA-1 對含表頭儲存格的表格有此要求。等同於呼叫 AddTagAttribute，Owner=Table、Name=Scope，並以範圍名稱作為值。

語法

Delphi

Function TPDFlib.SetStructElemScope(Const Scope: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemScope(Scope As String) As Long

DLL

int DLSetStructElemScope(int InstanceID, const wchar_t * Scope);

參數

Scope	表頭儲存格的作用範圍。必須是下列其中一個值（區分大小寫）： Column — 表頭適用於直欄中的所有儲存格 Row — 表頭適用於列中的所有儲存格 Both — 表頭同時適用於直欄與列

傳回值

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

備註

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

PDF/UA-1（ISO 14289-1 §7.10）要求表格的表頭儲存格與其資料儲存格明確關聯。在表格版面允許時，提供 /Scope 屬性是建議的做法。

範例

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

另見

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode