ReadStructureElements metóda

Component: TPdf · Unit: PDFium

Načíta vlastnenú snímku stromu štruktúry zakoreneného na jednej stránke

Syntax

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

Description

ReadStructureElements prejde stromom tagovanej štruktúry pre PageNumber (od jednej) a vráti vlastnené pole TPdfStructureElements s typmi, titulkami, MCID, indexmi potomkov a faktami o referenciách

Status vysvetlí prázdny výsledok a odlíši netagovaný dokument od ohraničeného alebo zlyhaného čítania

Remarks

Najprv pomocou IsTagged overte, či dokument vôbec nesie strom štruktúry
Opakované čítania sa obsluhujú z medzipamäte štruktúry; pozri StructureCacheCapacity a StructureElementsForPage
Pre veľmi hlboké stromy uprednostnite VisitStructureElements, ktorý streamuje návštevy namiesto materializovania celého poľa

Example

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