SetStructElemColSpan

Tagged PDF, Accessibility

Beschrijving

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

Syntaxis

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 beslaat. Moet een positief geheel getal zijn. Een waarde van 1 betekent dat de cel exact één kolom beslaat (standaardgedrag wanneer geen ColSpan is gezet). Waarden groter dan 1 duiden op een overlappende header- of datacel

Retourwaarde

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

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-attribuuteigenaar, Table 337)

Celoverspanning komt vaak voor in complexe tabellen — bijvoorbeeld een kolomkop die twee gegevenskolommen overspant. Door het attribuut /ColSpan op te geven kan hulptechnologie de celposities correct berekenen en koppen over het volledige tabelraster aan gegevenscellen koppelen

When a cell also spans multiple rows, use SetStructElemRowSpan in combination with this function.

Voorbeeld

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

Zie ook

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag