SetStructElemColSpan

Tagged PDF, Accessibility

Description

Legt das Attribut /ColSpan (Besitzer des Tabellenattributs) für das Strukturelement fest, das derzeit auf dem Tag-Stapel geöffnet ist; der Wert gibt an, wie viele Spalten die aktuelle Tabellenzelle überspannt; entspricht dem Aufruf von AddTagAttribute mit Owner=Table, Name=ColSpan und dem Ganzzahlwert als Zeichenfolge

Syntax

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	Die Anzahl der Spalten, über die sich die aktuelle Tabellenzelle erstreckt. Muss eine positive Ganzzahl sein. Ein Wert von 1 bedeutet, dass die Zelle genau eine Spalte belegt (Standardverhalten, wenn kein ColSpan festgelegt ist). Werte größer als 1 weisen auf eine überspannende Kopf- oder Datenzelle hin

Return value

Gibt 1 bei Erfolg zurück; gibt 0 zurück, wenn kein Dokument geöffnet ist oder derzeit kein Tag auf dem Tag-Stapel geöffnet ist

Remarks

Rufen Sie diese Funktion nach BeginTag (mit Tag-Typ TH oder TD) und vor EndTag auf; Das Attribut /ColSpan ist in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Tabelle 337) definiert

Legt das Attribut /WritingMode (Besitzer des Layoutattributs) für das Strukturelement fest, das derzeit auf dem Tag-Stapel geöffnet ist; der Schreibmodus deklariert die Hauptschreibrichtung des Textes innerhalb des Elements und beeinflusst, wie assistierende Technologien die Lesereihenfolge interpretieren; entspricht dem Aufruf von AddTagAttribute mit Owner=Layout, Name=WritingMode und dem Modusnamen als Wert

Wenn sich eine Zelle auch über mehrere Zeilen erstreckt, verwenden Sie SetStructElemRowSpan in Kombination mit dieser Funktion

Example

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