PDFium Delphi Component Docs

InspectPdfUaLanguageCoverage metode

Komponent: TPdf  ·  Enhed: PDFium
Rapporterer effektiv PDF/UA-sprogdækning for sidetekst og strukturens tilgængelighedsstrenge

Syntax

function InspectPdfUaLanguageCoverage: TPdfUaLanguageCoverageReport; overload;
function InspectPdfUaLanguageCoverage(const Options: TPdfUaLanguageCoverageOptions): TPdfUaLanguageCoverageReport; overload;

Description

Metoden scanner ikke-Artifact tekstsideobjekter plus strukturelementernes Title-, AlternateText-, ActualText- og Expansion-strenge

Det effektive sprog følger ISO 14289-1's nedarvningsrækkefølge: den inderste marked-content /Lang-deklaration, den nærmeste strukturforfader med et sprog og derefter katalogsproget

En ugyldig nærmere deklaration forbliver autoritativ og giver ikke-dækket evidence i stedet for at falde igennem til en gyldig ydre deklaration

Hvert TPdfUaLanguageSpan registrerer PageNumber, PageObjectIndex, MCID, StructureElementIndex, en ContentKind af pulckPageText, pulckTitle, pulckAlternateText, pulckActualText eller pulckExpansion, det fulde CharacterCount, et afgrænset Text-uddrag markeret med TextTruncated og det effektive sprog med dets DeclarationValid-tilstand

Sprogapløsningen rapporteres via TPdfUaLanguageResolution med Language-tagget, en Source af pulsNone, pulsCatalog, pulsStructure eller pulsMarkedContent, det oprindelige StructureElementIndex, DeclarationValid og hjælperen IsCovered

Standardindstillingerne gemmer kun ikke-dækkede spans, begrænser evidence til 1000 spans og hvert uddrag til 256 tegn, mens de aggregerede tællere fortsætter på tværs af hele dokumentet

Completed er False, når de påkrævede PDFium-API'er ikke er tilgængelige, en side ikke kan indlæses, eller afgrænset strukturgennemløb ikke kan fuldføres; allerede indsamlet evidence forbliver tilgængelig

Options and result

MemberPurpose
IncludeCoveredSpansGemmer dækket evidence såvel som ikke-dækket evidence
MaxReportedSpansBegrænser gemt evidence uden at stoppe den aggregerede optælling
MaxTextCharactersPerSpanBegrænser hvert gemt uddrag, mens CharacterCount bevares
CoveredSpanCount, UncoveredSpanCountAggregerede sprogdækningstællere ved siden af NaturalLanguageSpanCount
DocumentLanguage, PageCount, PagesScannedKatalogsprog-tag og sidescan-fremskridt i TPdfUaLanguageCoverageReport
ReportLimitReachedAngiver, at yderligere matchende spans blev talt, men ikke gemt
IsCoveredReturnerer kun True for en fuldført scanning uden ikke-dækkede spans

Example

var Report: TPdfUaLanguageCoverageReport;
Report := Pdf1.InspectPdfUaLanguageCoverage;
if Report.Completed and (Report.UncoveredSpanCount > 0) then
  ShowMessage(IntToStr(Report.UncoveredSpanCount) + ' language declarations required');

See Also

ValidatePdfUa, Structure traversal, PDF standards helpers