SetStructElemRowSpan

Tagged PDF, Accessibility

Description

Legt den strukturierten internen Logger fest, der an diese TPDFlib-Instanz angehängt ist, oder ruft ihn ab; wenn er festgelegt ist, erhält der Logger Debug/Info/Warn/Error-Einträge, die einen numerischen Code (unter Wiederverwendung der bestehenden FLastErrorCode-Taxonomie) und eine lesbare Meldung tragen

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parameters

RowSpan	Die Anzahl der Zeilen, über die sich die aktuelle Tabellenzelle erstreckt. Muss eine positive Ganzzahl sein. Ein Wert von 1 bedeutet, dass die Zelle genau eine Zeile belegt (Standardverhalten, wenn kein RowSpan festgelegt ist). Werte größer als 1 weisen auf eine Zelle hin, die sich über mehrere Zeilen erstreckt

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 /RowSpan ist in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Tabelle 337) definiert

Zeilenübergreifende Zellen treten in Tabellen auf, in denen sich eine Kopf- oder Datenzelle vertikal über mehrere Zeilen erstrecken muss — beispielsweise eine Zeilenkopfzeile, die von mehreren Datenzeilen gemeinsam genutzt wird; die Bereitstellung des Attributs /RowSpan ermöglicht es assistierenden Technologien, das logische Gittermodell der Tabelle korrekt aufzubauen

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

Example

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