ReadStructureElements methode

Component: TPdf · Unit: PDFium

Leest een eigen snapshot van de structuurboom die op één pagina geworteld is

Syntax

function ReadStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; out Status: TPdfStructureReadStatus): TPdfStructureElements;

Description

ReadStructureElements loopt de getagde structuurboom van PageNumber (ééngebaseerd) af en geeft een eigen TPdfStructureElements-array terug met typen, titels, MCID's, kid-indexen en referentiekenmerken

Status licht een leeg resultaat toe en scheidt een ongetagd document van een begrensde of mislukte leesactie

Remarks

Gebruik eerst IsTagged om te controleren of het document helemáál een structuurboom bevat
Herhaalde leesacties worden bediend vanuit de structuurcache; zie StructureCacheCapacity en StructureElementsForPage
Bij zeer diepe bomen verdient VisitStructureElements de voorkeur, dat bezoeken streamt in plaats van de hele array te materialiseren

Example

var St: TPdfStructureReadStatus;
Elements := Pdf1.ReadStructureElements(1, Default(TPdfStructureReadOptions), St);