SetStructElemScopeA

标记 PDF、可访问性

描述

末尾的 A 表示 ANSI（char）DLL 入口点，ActiveX/COM 接口仅公开 Unicode 形式。其行为与 SetStructElemScope 相同，字符串参数会按照当前的 SetAnsiMode 代码页进行解释

在当前于标签栈中打开的结构元素上设置 /Scope 属性（表属性所有者）。此范围标识 TH（表头）单元格适用于列、行还是两者；PDF/UA-1 要求含表头单元格的表格设置此项。等同于调用 AddTagAttribute，其中 Owner=Table、Name=Scope，范围名称作为值

语法

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

参数

Scope	表头单元格的作用域。必须是以下值之一（区分大小写）： Column — 表头适用于该列中的所有单元格 Row — 表头适用于该行中的所有单元格 Both — 表头同时适用于该列和该行

返回值

成功时返回 1。未打开文档或标签栈中当前没有打开标签时返回 0

备注

在 BeginTag（标签类型为 TH）之后且 EndTag 之前调用此函数。/Scope 属性定义于 ISO 32000-1 搂14.8.5.7.2（表格属性所有者）

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