SetStructElemRowSpan

Структурований PDF, Доступність

Опис

Встановлює атрибут /RowSpan (Table attribute owner) на елементі структури, зараз відкритому на стеці тегів. Значення вказує, скільки рядків охоплює поточна клітинка таблиці. Еквівалентно виклику 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