SetAutoTagMode

Tagged PDF

Beschreibung

Aktiviert die Struktur-Tag-Kennzeichnung, die gewöhnliche Zeichenaufrufe selbst mitführen.

Syntax

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Parameter

Mode	Bitmaske: `1` versieht Text mit Tags, `2` kennzeichnet Seitendekoration als Artefakte, `4` versieht Bilder als Abbildungen mit Tags, `8` versieht gezeichnete Tabellen mit Tags, `15` führt alle vier Vorgänge aus, `0` deaktiviert sie.

Rückgabewerte

Mode	Der vor diesem Aufruf wirksame Modus
0	Wird auch bei einem negativen Modus zurückgegeben; dieser wird abgelehnt und der Modus bleibt unverändert

Anmerkungen

Bei aktiviertem Text-Tagging wird Text als Absatz getaggt, und direkt nach RegisterHeading gezeichneter Text wird als Überschrift der entsprechenden Ebene getaggt. Bei aktivierter Kennzeichnung von Seitenausstattung werden laufende Kopf- und Fußzeilen als Artefakte markiert, damit ein Reader sie überspringt, statt auf jeder Seite dieselbe Zeile anzukündigen

Bei aktivierter Figure-Tag-Kennzeichnung wird ein gezeichnetes Bild zu einer Figure mit der von RegisterFigure hinterlegten Beschreibung oder innerhalb eines Layout-Artefakts gezeichnet, wenn RegisterDecoration angegeben hat, dass es keine Bedeutung trägt.

Bei aktiviertem Tabellen-Tagging überträgt DrawTableRows die Tabelle, ihre Zeilen und Zellen in den Strukturbaum. Die durch SetTableHeaderRowCount bezeichneten Zeilen werden zu Kopfzellen

Durch das Aktivieren des Modus wird das Dokument auch als getaggt gekennzeichnet. Ein Reader behandelt die Struktur als nicht vorhanden, bis diese Kennzeichnung gesetzt ist; ein ohne sie getaggtes Dokument wird daher so gelesen, als besäße es überhaupt keine Struktur

Das automatische Tagging greift innerhalb eines mit BeginTag geöffneten Tags nicht ein: Während der Aufrufer die Struktur selbst beschreibt, wird nichts in das geöffnete Element verschachtelt. Es taggt außerdem niemals innerhalb eines Artefakts, wo ein Strukturelement die Datei ungültig machen würde, und öffnet niemals ein Element für leeren Text, den ein Reader als Leerstelle ankündigen würde

Der Modus gehört zur Bibliotheksinstanz, nicht zu einem Dokument

Beispiel

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Siehe auch

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount