PDFium Delphi Component Docs

Methode GenerateTaggedLayout

Komponente: TPdf  ·  Units: PDFium, FPdfLayout

Syntax

function GenerateTaggedLayout(Layout: TPdfLayoutDocument; out Plan: TPdfLayoutPlan; const Language: string = 'en-US'): Boolean;

Beschreibung

Misst und gibt ein neues Layoutdokument aus, weist semantischen Seitenobjekten kontinuierliche MCIDs zu, markiert dekorativen Inhalt als Artifact, baut die Strukturhierarchie auf und lädt das fertige Tagged PDF wieder in denselben TPdf

Das Ziel muss inaktiv sein oder null Seiten enthalten, damit jedes Nicht-Artefakt-Objekt durch den generierten semantischen Plan abgedeckt wird

Die Methode lädt PDFium vor der Prüfung der Marked-Content-Fähigkeiten; sie kann die erste native Operation einer neuen TPdf-Instanz sein, ohne vorheriges CreateDocument

Semantisches Modell

AddText verwendet standardmäßig plsrParagraph, während Kopfzeilen, Fußzeilen, Linien, Bilder, Seiten-XObjects und zwischengespeicherte Knoten standardmäßig plsrArtifact verwenden

Rufen Sie SetLastItemSemantics auf, um Überschriften, Abschnitte, Unterteilungen, Abbildungen, Beschriftungen, Listenrollen, Tabellenrollen, Alternativtext, Isttext, Sprache, IDs, Tabellenbereich, Spannen oder Kopfzeilen-IDs zuzuweisen

Verwenden Sie AddSemanticNode für nicht-visuelle Listen- und Tabellencontainer und verbinden Sie dann Nachkommen über ElementID und ParentID

Getaggte Links

AddLink fügt gemessenen URI-Text und eine Link-Anmerkung hinzu

Die generierte Anmerkung wird bei Bedarf in ein indirektes Objekt umgewandelt, erhält einen StructParent-Schlüssel und wird über OBJR- und ParentTree-Einträge mit ihrem Link-Strukturelement verknüpft

Validierung

Der Messdurchlauf lehnt doppelte IDs, unaufgelöste Eltern, Zyklen, ungültige Listen- oder Tabellenverschachtelung, Abbildungen ohne Alternativ- oder Isttext, ungültige Spannen und Bereiche sowie unaufgelöste Tabellen-Kopfzeilen-IDs ab

Die Generierung lehnt verschlüsselte Ausgabe, einen vorhandenen Strukturbaum, nicht übereinstimmende Seiten- oder Objektanzahlen, doppelte MCIDs, unvollständige Anmerkungszuordnungen und konfigurierte Objektbudget-Überschreitungen ab

Ergebnis

Plan enthält zusätzlich zu den normalen Layout-Metriken semantische Elemente, Elternindizes, MCIDs, Link-Anmerkungsindizes, Getaggt-Inhalts-Anzahlen und Artefakt-Anzahlen

Das fertige Dokument trägt ein Document-Strukturelement, ParentTree, IDTree wenn IDs vorhanden sind, MarkInfo, Dokumentsprache, Seiten-StructParents und strukturbasierte Tabulatorreihenfolge für Seiten mit Anmerkungen

Erweiterte Tabellen

TPdfLayoutTableCell.AddTextRun erhält gemischte Textstile als nativen extrahierbaren Text; SetImage erzeugt eine Figure mit Alternativtext unter der ursprünglichen Zelle

Mit AllowRowSpanContinuation=True umfasst ein TH oder TD alle physischen Seitenfragmente über seitenspezifische MCR-Einträge und erhält RowSpan, ColumnSpan und Headerbeziehungen

Zwischensummen bleiben Körperzeilen, Fortsetzungslabels sind Artifact; Bedingungen und Budgets stehen unter FPdfLayout

Siehe auch

GenerateLayout, ValidatePdfUa, ReadableContent