SetStructElemScopeA

Tagged PDF, Barrierefreiheit

Beschreibung

Das abschließende A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten ist identisch mit SetStructElemScope, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Legt das Attribut /Scope (Attributinhaber Table) für das aktuell im Tag-Stack geöffnete Strukturelement fest. Der Gültigkeitsbereich kennzeichnet, ob eine TH-Zelle (Tabellenkopf) für eine Spalte, eine Zeile oder beides gilt — dies ist für Tabellen mit Kopfzellen gemäß PDF/UA-1 erforderlich. Entspricht einem Aufruf von AddTagAttribute mit Owner=Table, Name=Scope und dem Namen des Gültigkeitsbereichs als Wert

Syntax

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

Parameter

Scope	Der Gültigkeitsbereich der Kopfzelle. Muss einer der folgenden Werte sein, wobei die Groß-/Kleinschreibung beachtet wird: Column — die Kopfzeile gilt für alle Zellen der Spalte Row — die Kopfzeile gilt für alle Zellen der Zeile Both — die Kopfzeile gilt sowohl für die Spalte als auch für die Zeile

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 Tag-Typ TH) und vor EndTag auf. Das Attribut /Scope ist in ISO 32000-1 §14.8.5.7.2 (Table-Attribut-Eigentümer) definiert.

PDF/UA-1 (ISO 14289-1 §7.10) verlangt, dass Tabellenkopfzellen ihren Datenzellen eindeutig zugeordnet sind. Das Attribut /Scope ist der empfohlene Mechanismus, wenn das Tabellenlayout dies zulässt

Beispiel

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Siehe auch

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode