AddTagAttribute

Tagged PDF, Barrierefreiheit

Beschreibung

Fügt dem aktuell auf dem Tag-Stapel erstellten Strukturelement ein benanntes Attribut hinzu. Das Attribut wird beim Speichern des Dokuments als PDF-Attributwörterbuch /A oder als Array von Wörterbüchern geschrieben. Rufen Sie dies nach BeginTag oder BeginTagEx und vor EndTag auf

Syntax

Delphi

Function TPDFlib.AddTagAttribute(Const Owner, Name, Value: WideString): Integer;

ActiveX

Function PDFlib::AddTagAttribute(Owner As String, Name As String, Value As String) As Long

DLL

int DLAddTagAttribute(int InstanceID, const wchar_t * Owner, const wchar_t * Name, const wchar_t * Value);

Parameter

Owner	Der Name des Attributeigentümers gemäß ISO 32000-1 Tabelle 348, beispielsweise `Layout`, `Table`, `List` oder `PrintField`. Dieser Wert wird zum Schlüssel `/O` im Attributwörterbuch
Name	Der Attributname für den angegebenen Inhaber, beispielsweise `BBox` für Layout oder `Scope` für Table. Darf nicht leer sein
Value	Der Attributwert als Zeichenfolge. Eine einzelne Zahl wird als PDF-Zahl geschrieben, und Werte, die nur durch Leerzeichen getrennte Zahlen enthalten, beispielsweise `"0 0 200 100"`, werden als PDF-Array reeller Zahlen geschrieben. Zahlen verwenden auf jedem System den Punkt als Dezimaltrennzeichen; eine Zahl, die mit dem eigenen Dezimaltrennzeichen des Systems geschrieben wurde, wird ebenfalls akzeptiert. Jeder andere Wert wird als PDF-Namensobjekt ohne führendes `/` geschrieben. Darf nicht leer sein

Rückgabewert

Gibt bei Erfolg 1 zurück. Gibt 0 zurück, wenn kein Dokument geöffnet, kein Tag offen oder Owner bzw. Name leer ist

Anmerkungen

Mehrere Aufrufe von AddTagAttribute für dasselbe offene Tag werden gesammelt. Gehören Attribute einem einzigen Inhaber, schreibt die Bibliothek ein einzelnes Attributwörterbuch /A. Werden mehrere Inhaber verwendet, werden die Attribute nach Inhaber gruppiert und als Array von Attributwörterbüchern geschrieben

Für häufige Attribute können die Komfort-Wrapper SetStructElemScope und SetStructElemBBox verwendet werden, anstatt AddTagAttribute direkt aufzurufen

Attribute werden beim Öffnen eines neuen Tags zurückgesetzt und nicht von untergeordneten Elementen geerbt.

Beispiel

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

Siehe auch

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox