THotPDF.ValidatePDFUA2Structure Method
Provede ohraničenou strukturní validaci PDF/UA-2 nad producer nebo načteným object grafem a vrátí stabilní strukturovanou diagnostiku, aniž by dokument měnila
Deklarace
function ValidatePDFUA2Structure(
const Options: THPDFUA2ValidationOptions;
out Issues: THPDFUA2ValidationIssues): boolean; overload;
function ValidatePDFUA2Structure(
const Options: THPDFUA2ValidationOptions;
out Findings: THPDFComplianceFindings): boolean; overload;
Jednotka
HPDFDoc
Validační volby
Pro přísnou validační generaci použijte THPDFUA2ValidationOptions.Default nebo si pro intake diagnostiku upravte jednotlivé sémantické politiky
| Pole | Účel |
|---|---|
HeadingPolicy | Přeskočené úrovně nadpisů ignoruje, diagnostikuje nebo odmítne |
AllowDocumentFragmentHeadingStarts | Resetuje kontext nadpisů uvnitř DocumentFragment |
CheckDocumentSemantics | Zkontroluje jazyk Catalogu, metadata, zobrazovaný titulek, optional content i vložené soubory |
CheckHumanReadableStrings | Odmítne znaky Unicode private use v čitelných řetězcích |
CheckAnnotationSemantics | Zkontroluje pořadí procházení stránky tabulátorem, vlastnictví anotací, role, příznaky, popisy i appearance streamy |
CheckFormSemantics | Zkontroluje pole AcroForm, widgety, popisky, akce, volby i rich hodnoty |
CheckNavigationSemantics | Zkontroluje structure destinations, osnovy i vnořené number tree page labelů |
RequireListLabels | Vyžaduje jedno Lbl pro každou číslovanou položku seznamu |
RequireExplicitTableHeaderAssociations | Nahlásí datové buňky, které spoléhají jen na odvození ze scope |
CheckListSemantics | Zkontroluje číslování, continuation řetězce, caption, popisky, těla i přímé umístění skutečného obsahu |
CheckTableSemantics | Zkontroluje ohraničenou mřížkovou geometrii, skupiny řádků, span, scope i tabulkově lokální vazby headerů |
CheckRubyWarichuSequences | Zkontroluje přesné sekvence přímých dětí vyžadované pro Ruby a Warichu |
CheckPronunciationHints | Zkontroluje typy pronunciation položek i nepřímé vložené PLS lexikony |
RequireStructureAssociatedFiles | Vyžaduje, aby každý associated file v catalogu byl dosažitelný ze struktury |
RequireFormulaTextAlternative | Vyžaduje Alt, ActualText nebo připojené MathML pro vzorce |
MaxObjects | Ohraničí scan nepřímých objektů, výchozích 1 000 000 objektů |
MaxIssues | Ohraničí uchovávanou diagnostiku, výchozích 256 issues |
Návratová hodnota
Vrací True jen tehdy, když nezůstane žádná diagnostika uisError
Diagnostika
THPDFUA2IssueSeverity rozliší varování a chyby, zatímco každá THPDFUA2ValidationIssue nese stabilní namespaced kód, příslušnou klauzuli, object path, číslo objektu, index stránky od nuly, pokud je známý, a čitelnou zprávu v poli THPDFUA2ValidationIssues
- Validace nikdy nevytvoří chybějící
StructTreeRootani namespace slovník - Role mapy citlivé na namespace se řeší tranzitivně s detekcí cyklů a hloubky
- Metadata dokumentu, čitelné řetězce, optional content, strukturální elementy, zpětné odkazy na rodiče, atributy, anotace, formuláře, navigace, associated files, nadpisy, seznamy, tabulky, Ruby, Warichu, pronunciation hinty, vzorce i MathML se zkontrolují v jednom ohraničeném průchodu
- Vlastnictví načtených anotací se řeší z fyzického ParentTree a podporuje skalární či pole
Kpoložek, aniž by se spoléhalo na stav produceru - Lokální navigace vyžaduje structure destinations, upřednostní
SDpřed kompatibilním fallbackemDa zvaliduje vnořené number tree page labelů - Vlastnosti XMP se řeší podle namespace URI, takže platné alternativní prefixy zůstávají interoperabilní
- Tabulková diagnostika rozliší neplatné span, průniky buněk, nepravidelné řádky a skupiny řádků, ID napříč tabulkami, duplicitní či cyklické header reference i chybějící algoritmické vazby
- Diagnostika seznamů rozliší neplatné číslování, nezabalený obsah, strukturu popisků a těla, seřazené same-level continuation reference i continuation cykly
- Rozšířená tabulková geometrie sdílí limit
MaxObjectsa selhává uzavřeně sua2.table.limit.cells ua2.limit.objectsselže uzavřeně dřív, než se skenuje příliš velký graf
Strojově čitelné nálezy
Overload s THPDFComplianceFindings namapuje tentýž ohraničený validační průchod do shared compliance modelu, aniž by změnil pořadí validace nebo upravil graf
Každý nález identifikuje PDF/UA-2, závažnost, ID pravidla, klauzuli standardu, cestu, číslo objektu, index stránky, zprávu a repair stav crsNotAttempted