SetStructElemRowSpan

Маркиран PDF, достъпност

Описание

Задава атрибута /RowSpan (собственик на атрибути Table) върху структурния елемент, който в момента е отворен в стека на таговете. Стойността указва колко реда обхваща текущата клетка в таблицата. Еквивалентно е на извикване на 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, Таблица 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