SetStructElemColSpan

Tagged PDF, Accessibility

Description

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

Syntax

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parameters

ColSpan	Het aantal kolommen dat de huidige tabelcel overspant. Moet een positief geheel getal zijn. Een waarde van 1 betekent dat de cel precies één kolom in beslag neemt (standaardgedrag wanneer er geen ColSpan is ingesteld). Waarden groter dan 1 duiden op een overspannende kop- of datacel

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 /ColSpan is gedefinieerd in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Tabel 337)

Samenvoegcellen zijn gebruikelijk in complexe tabellen — bijvoorbeeld een kolomkop die zich over twee gegevenskolommen uitstrekt; het opgeven van het attribuut /ColSpan stelt ondersteunende technologie in staat om celposities correct te berekenen en koppen te koppelen aan gegevenscellen over het hele tabelraster

Wanneer een cel ook meerdere rijen beslaat, gebruikt u SetStructElemRowSpan in combinatie met deze functie

Example

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;