SetStructElemRowSpan

Tagged PDF, Tilgængelighed

Beskrivelse

Indstiller attributten /RowSpan (Table-attributindehaver) på det strukturelement, der aktuelt er åbent på tagstakken. Værdien angiver, hvor mange rækker den aktuelle tabelcelle strækker sig over. Svarer til at kalde AddTagAttribute med Owner=Table, Name=RowSpan og heltalsværdien 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);

Parametre

RowSpan	Antallet af rækker, som den aktuelle tabelcelle spænder over. Skal være et positivt heltal. En værdi på 1 betyder, at cellen optager præcis én række (standardadfærd, når RowSpan ikke er angivet). Værdier over 1 angiver en celle, der spænder over flere rækker.

Returværdi

Returnerer 1 ved succes. Returnerer 0, hvis intet dokument er åbent, eller intet tag aktuelt er åbent på tagstakken

Bemærkninger

Kald denne funktion efter BeginTag (med tagtypen TH eller TD) og før EndTag. Attributten /RowSpan er defineret i ISO 32000-1 §14.8.5.7.2 (Table-attributejer, tabel 337)

Celler, der spænder over rækker, forekommer i tabeller, hvor en overskrifts- eller datacelle skal strække sig lodret over flere rækker – for eksempel en rækkeoverskrift, der deles af flere datarækker. At angive attributten /RowSpan gør det muligt for hjælpeteknologi at opbygge tabellens logiske gittermodel korrekt.

Når en celle også strækker sig over flere kolonner, bruges SetStructElemColSpan sammen med denne funktion.

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