PDFlib API-Referenz 9.0.2

unden, auf der sie geöffnet wurden, sondern können auf einer beliebigen Anzahl von
Seiten fortgesetzt werden. Wir empfehlen, auf leere Strukturelemente zu verzichten.
Strukturelemente und Alt/ActualText-Attribute müssen gemäß den Regeln im
PDFlib-Tutorial verschachtelt werden. Einige Elemente für die Textdekoration werden
automatisch als Artifact ausgezeichnet; für weitere Informationen siehe PDFlib-Tutorial.
PDF/A
PDF/UA
Gültigkeit
Obwohl das Anbringen von Tags für PDF/A-1a/2a/3a erforderlich ist, gibt es keine
besonderen Anforderungen bezüglich Tag-Nutzung oder Verschachtelung.
Alle Texte erfordern eine natürliche Sprachspezifikation.
Bild- und Grafikinhalte müssen als Artifact oder Figure ausgezeichnet werden.
Für manche Elementtypen und Optionen gelten zusätzliche Regeln (siehe PDFlib-Tutorial).
page; für Gruppierungselemente auch document; diese Funktion muss immer paarweise
mit PDF_end_item( ) aufgerufen werden. Sie ist nur im Tagged-PDF-Modus zulässig.
Tabelle 14.4 Optionen für Struktur- und Pseudo-Tags in PDF_begin_item( ) PDF_begin_mc( ) und PDF_mc_point( ) sowie
für vereinfachtes Tagging mit der Option tag verschiedener Funktionen
Option
ActualText
Alt
artifactsubtype
artifacttype
Attached
BBox
bookmark
ColSpan
Beschreibung
(Hypertext-String; nicht für Pseudo-Tags außer in PDF 1.5 für ASpan; wird diese Option im PDF-1.4-Modus
verwendet, muss die Option inline auf false gesetzt sein) Alternativtext für den Dokumentbestandteil
einschließlich seiner untergeordneten Elemente.
(Hypertext-String; nicht für Pseudo-Tags außer in PDF 1.5 für ASpan; wird diese Option im PDF-1.4-Modus
verwendet, muss die Option inline auf false gesetzt sein) Alternative Beschreibung für den Dokumentbestandteil
einschließlich seiner untergeordneten Elemente. Sie sollte für Bilder usw. übergeben werden,
die sich nicht als Text interpretieren lassen.
(Schlüsselwort; nur für tagname=Artifact und artifacttype=Pagination; PDF 1.7) Untertyp des Artefakts:
Header, Footer, Watermark
(Schlüsselwort; nur für tagname=Artifact) Bezeichnet den Artefakttyp des Dokumentbestandteils:
Pagination Paginierungseigenschaften wie Kolumnentitel oder Seitenzahlen
Layout Kosmetische typografische oder Layout-Elemente wie Fußnotenlinien oder Tabellenschattierung
Page Produktionshilfen wie Beschnittmarken oder Farbbalken
Background (PDF 1.7) Über die gesamte Länge und/oder Breite einer Seite oder eines Strukturelements
verlaufende Bilder oder farbige Bereiche.
(Schlüsselwortliste; nur für tagname=Artifact und artifacttype=Pagination oder Background mit
ganzseitigen Hintergrund-Artefakten) Legt die Kanten der Seite fest, falls dies der Fall ist, an die das Artefakt
logisch angehängt ist. Die Liste enthält ein bis vier der Schlüsselwörter Top, Bottom, Left und Right.
Sind sowohl Left als auch Right bzw. sowohl Top als auch Bottom vorhanden, handelt es sich um ein Artefakt
über die gesamte Seitenbreite bzw. über die gesamte Seitenhöhe.
(Rechteck; nur für tagname=Artifact , Figure, Form, Table; erforderlich für artifacttype=Background,
sonst optional, aber für das Umfließen von Text ratsam) Die Größe der Bounding-Box des Elements in
Standardkoordinaten (bei usercoordinates=false) oder in Benutzerkoordinaten (bei usercoordinates=true).
PDFlib erzeugt automatisch einen BBox-Eintrag für importierte Bilder, Grafiken und PDF-
Seiten (mit tagname=Figure oder Artifact), für Formularfelder (mit tagname=Form oder Artifact) und
für Tabellen, die mit dem Tabellengenerator erzeugt wurden (mit tagname=Table or Artifact).
(Lesezeichen-Handle; nicht für Inline- und Pseudo-Tags) Handle für ein Lesezeichen, das mit dem Strukturelement
verknüpft ist.
(Integer; nur für tagname=TH und TD) Anzahl der von einer Zelle belegten Tabellenspalten.
Standardwert: 1
274 Kapitel 14: Dokumentaustausch