PDFium Component Docs

GenerateTaggedLayout functie

Component: TPdf  ·  Units: PDFium, FPdfLayout

Syntax

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

Description

Meet en genereert een nieuw lay-outdocument, wijst doorlopende MCIDs toe aan semantische pagina-objecten, markeert decoratieve inhoud als Artifact, bouwt de structuurhiërarchie op en laadt de voltooide Tagged PDF opnieuw in dezelfde TPdf

De bestemming moet inactief zijn of nul pagina's bevatten, zodat elk niet-artifact object wordt gedekt door het gegenereerde semantische plan

De methode laadt PDFium voordat marked-content-capabilities worden gecontroleerd, zodat het de eerste native bewerking op een nieuwe TPdf-instantie kan zijn zonder een voorafgaande CreateDocument-aanroep

Semantic model

AddText krijgt standaard plsrParagraph, terwijl koppen, voetteksten, lijnen, afbeeldingen, pagina-XObjects en gecachte nodes standaard plsrArtifact krijgen

Roep SetLastItemSemantics aan om koppen, secties, divisies, figuren, bijschriften, lijstrollen, tabelrollen, alternatieve tekst, actual text, taal, ID's, tabel-scope, spans of header-ID's toe te wijzen

Gebruik AddSemanticNode voor niet-visuele lijst- en tabelcontainers en verbind vervolgens afstammelingen via ElementID en ParentID

Tagged links

AddLink voegt gemeten URI-tekst en een Link-annotatie toe

De gegenereerde annotatie wordt zo nodig geconverteerd naar een indirect object, krijgt een StructParent-sleutel en wordt via OBJR- en ParentTree-items gekoppeld aan het bijbehorende Link-structuurelement

Validation

De meetfase wijst dubbele ID's, onopgeloste ouders, cycli, ongeldige lijst- of tabelcontainment, figuren zonder alternatieve tekst of actual text, ongeldige spans en scope, en onopgeloste tabel-header-ID's af

De generatie wijst versleutelde uitvoer, een bestaande structuurboom, niet-overeenkomende pagina- of objecttellingen, dubbele MCIDs, onvolledige annotatietoewijzingen en overschrijdingen van het geconfigureerde objectbudget af

Result

Plan bevat naast de gebruikelijke lay-outstatistieken ook semantische elementen, ouder-indexen, MCIDs, link-annotatie-indexen, tellingen van getagde inhoud en artifact-tellingen

Het voltooide document bevat een Document-structuurelement, ParentTree, IDTree wanneer ID's aanwezig zijn, MarkInfo, documenttaal, StructParents per pagina en een op de structuur gebaseerde tabvolgorde voor pagina's met annotaties

Geavanceerde tabellen

TPdfLayoutTableCell.AddTextRun houdt gemengde tekststijlen als native, extraheerbare tekst; SetImage emitteert een Figure met alternatieve tekst onder de oorspronkelijke tabelcel

Met AllowRowSpanContinuation=True overspant één TH of TD al zijn fysieke paginifragmenten via paginaspecifieke MCR-items, met behoud van RowSpan, ColumnSpan en headerrelaties

Subtotaalrijen blijven bodyrijen en continuatielabels worden als Artifact gemarkeerd; zie FPdfLayout voor beperkingen en budgetten

See Also

GenerateLayout, ValidatePdfUa, ReadableContent