SetStructElemColSpan

Tagged PDF, Accessibility

Beskrivelse

Setjer /ColSpan-attributtet (Table attribute owner) på strukturelementet som står åpent på tag-stakken akkurat nå. Verdien angir hvor mange kolonner gjeldende tabellcelle spenner over. Tilsvarer å kalle AddTagAttribute med Owner=Table, Name=ColSpan og heltallsverdien som streng

Syntaks

Delphi

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

ActiveX

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

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parametere

ColSpan	Antall kolonner gjeldende tabellcelle spenner over. Må være et positivt heltall. Verdien 1 betyr at cellen opptar nøyaktig én kolonne (standardoppførsel når ingen ColSpan er satt). Verdier større enn 1 indikerer en overskrifts- eller datacelle som spenner over

Returverdi

Returnerer 1 ved suksess. Returnerer 0 hvis ingen dokument er åpent eller ingen tag står øverst på tag-stakken

Merknader

Kall denne funksjonen etter BeginTag (med taggtype TH eller TD) og før EndTag. Attributten /ColSpan er definert i ISO 32000-1 §14.8.5.7.2 (Table-attributteier, tabell 337)

Spennende celler er vanlige i komplekse tabeller — for eksempel en kolonnetopptekst som spenner over to datakolonner. Å oppgi /ColSpan-attributten lar assistiv teknologi beregne celleposisjoner riktig og knytte topptekster til dataceller på tvers av hele tabellrutenettet

Når en celle også spenner over flere rader, bruk SetStructElemRowSpan i kombinasjon med denne funksjonen

Eksempel

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

Se også

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag