SetStructElemRowSpan

Tagged PDF, Accessibility

Description

Stelt het /RowSpan-attribuut (Table-attribuuteigenaar) in op het structuurelement dat momenteel geopend is op de tag-stack; de waarde geeft aan over hoeveel rijen de huidige tabelcel zich uitstrekt; dit is gelijk aan het aanroepen van AddTagAttribute met Owner=Table, Name=RowSpan en de integerwaarde als een string

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	Het aantal rijen dat de huidige tabelcel overspant. Moet een positief geheel getal zijn. Een waarde van 1 betekent dat de cel precies één rij beslaat (standaardgedrag wanneer er geen RowSpan is ingesteld). Waarden groter dan 1 duiden op een cel die meerdere rijen overspant

Return value

Retourneert 1 bij succes; retourneert 0 als er geen document open is of als er momenteel geen tag open is op de tag-stack

Remarks

Roep deze functie aan na BeginTag (met tagtype TH of TD) en vóór EndTag; het attribuut /RowSpan is gedefinieerd in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Tabel 337)

Rijenoverspannende cellen verschijnen in tabellen waar een kop- of datacel verticaal over meerdere rijen moet worden uitgerekt — bijvoorbeeld een rijkop die wordt gedeeld door meerdere datarijen; het opgeven van het /RowSpan-attribuut stelt ondersteunende technologie in staat om het logische rastermodel van de tabel correct op te bouwen

Wanneer een cel ook meerdere kolommen beslaat, gebruikt u SetStructElemColSpan in combinatie met deze functie

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;