SetStructElemRowSpan

Tagged PDF, Barrierefreiheit

Beschreibung

Legt das Attribut /RowSpan (Attributinhaber Table) für das aktuell im Tag-Stack geöffnete Strukturelement fest. Der Wert gibt an, über wie viele Zeilen sich die aktuelle Tabellenzelle erstreckt. Entspricht einem Aufruf von AddTagAttribute mit Owner=Table, Name=RowSpan und dem Ganzzahlwert als Zeichenfolge

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parameter

RowSpan	Die Anzahl der Zeilen, über die sich die aktuelle Tabellenzelle erstreckt. Muss eine positive Ganzzahl sein. Der Wert 1 bedeutet, dass die Zelle genau eine Zeile belegt, was dem Standardverhalten entspricht, wenn kein RowSpan festgelegt ist. Werte größer als 1 kennzeichnen eine Zelle, die sich über mehrere Zeilen erstreckt

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 /RowSpan ist in ISO 32000-1 §14.8.5.7.2 (Tabellenattribut-Eigentümer, Tabelle 337) definiert.

Zeilenüberspannende Zellen treten in Tabellen auf, wenn sich eine Kopf- oder Datenzelle vertikal über mehrere Zeilen erstrecken muss, beispielsweise eine gemeinsame Zeilenüberschrift für mehrere Datenzeilen. Mit dem Attribut /RowSpan können Hilfstechnologien das logische Rastermodell der Tabelle korrekt erstellen

Wenn sich eine Zelle auch über mehrere Spalten erstreckt, verwenden Sie SetStructElemColSpan zusammen mit dieser Funktion

Beispiel

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

Siehe auch

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag