SetStructElemRowSpan

Getagde PDF, toegankelijkheid

Beschrijving

Zet het attribuut /RowSpan (Table-attribuuteigenaar) op het structuurelement dat momenteel open staat op de tagstack. De waarde geeft aan over hoeveel rijen de huidige tabelcel loopt. Gelijk aan het aanroepen van AddTagAttribute met Owner=Table, Name=RowSpan en de integerwaarde als string

Syntaxis

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

Retourwaarde

Retourneert 1 bij succes. Retourneert 0 als er geen document is geopend of momenteel geen tag op de tagstack geopend is

Opmerkingen

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

Rij-overspannende cellen komen voor in tabellen waar een header- of datacel verticaal over meerdere rijen moet doorlopen — bijvoorbeeld een rijheader die door meerdere datarijen wordt gedeeld. Het attribuut /RowSpan opgeven laat hulptechnologie het logische rastermodel van de tabel correct opbouwen

Wanneer een cel ook meerdere kolommen overspant, gebruik dan SetStructElemColSpan in combinatie met deze functie

Voorbeeld

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

Zie ook

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag