AddTagAttributeA
Tagged PDF, Barrierefreiheit
Beschreibung
Das angehängte A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten ist mit AddTagAttribute identisch, und Zeichenfolgenargumente werden anhand der aktuellen SetAnsiMode-Codeseite interpretiert
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 DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;DLL
int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * 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. Werte, die nur durch Leerzeichen getrennte Zahlen enthalten, beispielsweise "0 0 200 100", werden als PDF-Array reeller Zahlen geschrieben. 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