SetStructElemColSpan

Tagged PDF, Tilgængelighed

Beskrivelse

Angiver attributten /ColSpan (Table-attributindehaver) på det strukturelement, der aktuelt er åbent øverst på tagstakken. Værdien angiver, hvor mange kolonner den aktuelle tabelcelle spænder over. Svarer til at kalde AddTagAttribute med Owner=Table, Name=ColSpan og heltalsværdien som en 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);

Parametre

ColSpan	Antallet af kolonner, som den aktuelle tabelcelle strækker sig over. Skal være et positivt heltal. Værdien 1 betyder, at cellen optager præcis én kolonne (standardadfærd, når ColSpan ikke er angivet). Værdier over 1 angiver en overskrifts- eller datacelle, der strækker sig over flere kolonner.

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 /ColSpan er defineret i ISO 32000-1 §14.8.5.7.2 (Table-attributindehaver, Table 337).

Celler, der spænder over flere rækker eller kolonner, er almindelige i komplekse tabeller — f.eks. en kolonneoverskrift, der spænder over to datakolonner. At angive attributten /ColSpan gør det muligt for hjælpeteknologi at beregne cellepositioner korrekt og knytte overskrifter til dataceller i hele tabelgitteret

Når en celle også spænder over flere rækker, skal SetStructElemRowSpan bruges sammen med denne funktion

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