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 属性所有者，表 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