SetStructElemRowSpan

Tagged PDF, Accessibility

Description

Sätter /RowSpan-attributet (Table-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Värdet anger hur många rader den aktuella tabellcellen spänner över. Ekvivalent med att anropa AddTagAttribute med Owner=Table, Name=RowSpan och heltalsvärdet som sträng

Syntax

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parameters

RowSpan	Antalet rader den aktuella tabellcellen spänner över. Måste vara ett positivt heltal. Värdet 1 betyder att cellen upptar exakt en rad (standardbeteende när ingen RowSpan satts). Värden större än 1 indikerar en cell som spänner över flera rader

Return value

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Remarks

Anropa den här funktionen efter BeginTag (med taggtyp TH eller TD) och före EndTag. Attributet /RowSpan är definierat i ISO 32000-1 §14.8.5.7.2 (Table-attributägare, tabell 337)

Radspännande celler förekommer i tabeller där en rubrik- eller datacell behöver sträcka sig vertikalt över flera rader — till exempel en radrubrik delad av flera datarader. Att tillhandahålla attributet /RowSpan låter hjälpmedelsteknik korrekt bygga tabellens logiska rutnätsmodell

När en cell också spänner över flera kolumner, använd SetStructElemColSpan i kombination med den här funktionen

Example

// 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;