SetStructElemRowSpan

标记 PDF、可访问性

描述

在标签堆栈中当前打开的结构元素上设置 /RowSpan 属性（表格属性所有者），该值表示当前表格单元格跨越的行数，等同于调用 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（表属性所有者，表 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