SetStructElemColSpan

Tagged PDF, Barrierefreiheit

Beschreibung

Legt das Attribut /ColSpan (Table-Attribut-Eigentümer) auf dem derzeit im Tag-Stapel geöffneten Strukturelement fest. Der Wert gibt an, wie viele Spalten die aktuelle Tabellenzelle überspannt. Entspricht einem 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);

Parameter

ColSpan	Die Anzahl der Spalten, über die sich die aktuelle Tabellenzelle erstreckt. Muss eine positive Ganzzahl sein. Der Wert 1 bedeutet, dass die Zelle genau eine Spalte belegt (Standardverhalten, wenn kein ColSpan festgelegt ist). Werte über 1 kennzeichnen eine spaltenübergreifende Kopf- oder Datenzelle

Rückgabewert

Gibt bei Erfolg 1 zurück. Gibt 0 zurück, wenn kein Dokument geöffnet oder aktuell kein Tag im Tag-Stapel geöffnet ist.

Anmerkungen

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

Verbundene Zellen kommen in komplexen Tabellen häufig vor — beispielsweise eine Spaltenüberschrift, die sich über zwei Datenspalten erstreckt. Das Attribut /ColSpan ermöglicht Hilfstechnologien, Zellpositionen korrekt zu berechnen und Kopfzellen über das gesamte Tabellenraster hinweg mit Datenzellen zu verknüpfen.

Wenn sich eine Zelle zugleich über mehrere Zeilen erstreckt, verwenden Sie SetStructElemRowSpan zusammen mit dieser Funktion.

Beispiel

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

Siehe auch

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag