SetStructElemHeadersA

Tagged PDF, Barrierefreiheit

Beschreibung

Das nachgestellte A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten entspricht SetStructElemHeaders, und Zeichenfolgenargumente werden mit der aktuellen Codepage von SetAnsiMode interpretiert

Legt das Attribut /Headers (Attributinhaber Table) für das aktuell im Tag-Stack geöffnete Strukturelement fest. Das Attribut ordnet die aktuelle Datentabellen- oder Kopfzelle einer oder mehreren anhand ihrer Element-IDs gekennzeichneten Tabellenkopfzellen zu. Dies dient zur Beschreibung komplexer Tabellenstrukturen, die sich nicht allein aus der Position ableiten lassen. Rufen Sie dies nach BeginTag oder BeginTagEx und vor EndTag auf

Syntax

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

Parameter

Headers	Eine durch Kommas getrennte Liste von Element-IDs der TH-Zellen, die Spalten- oder Zeilenüberschriften für die aktuelle TD- oder TH-Zelle sind. Jede ID muss mit einer ElemID übereinstimmen, die zuvor im selben Dokument über SetStructElemID einem TH-Element zugewiesen wurde. Leerraum um Kommas wird ignoriert. Beispiel: `TH-ProductName,TH-Price`

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

Diese Funktion entspricht einem Aufruf von AddTagAttribute mit Owner=Table, Name=Headers und derselben durch Kommas getrennten ID-Liste als Value. Das Attribut wird als Array /Headers von PDF-Textzeichenfolgen in das Attributwörterbuch /A des Strukturelements geschrieben

Das Attribut /Headers ist in ISO 32000-1 §14.8.5.7.2 (Attributinhaber Table) definiert. Für einfache Tabellen, bei denen sich Spaltenüberschriften direkt über ihren Datenzellen befinden, genügt im Allgemeinen das Attribut /Scope, das über SetStructElemScope festgelegt wird. Verwenden Sie /Headers für unregelmäßige Tabellen mit verbundenen Zellen oder mehrstufigen Überschriften

PDF/UA-1 (ISO 14289-1 §7.10) verlangt, dass jede TD-Zelle explizit ihren Kopfzellen zugeordnet ist, wenn die Zuordnung in einer Tabelle nicht allein aus der Lesereihenfolge bestimmt werden kann

Beispiel

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Siehe auch

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode