SetStructElemRowSpan

Tagget PDF, tilgjengelighet

Beskrivelse

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

Syntaks

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parametere

RowSpan	Antall rader gjeldende tabellcelle spenner over. Må være et positivt heltall. Verdien 1 betyr at cellen opptar nøyaktig én rad (standardoppførsel når ingen RowSpan er satt). Verdier større enn 1 indikerer en celle som spenner over flere rader

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 /RowSpan er definert i ISO 32000-1 §14.8.5.7.2 (Table-attributteier, tabell 337)

Radspennende celler forekommer i tabeller der en topptekst- eller datacelle må strekke seg vertikalt over flere rader — for eksempel en radtopptekst delt av flere datarader. Å oppgi /RowSpan-attributten lar assistiv teknologi bygge tabellens logiske rutenettmodell riktig

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

Eksempel

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

Se også

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag