ReadStructureElements Metoda

Component: TPdf · Unit: PDFium

Odczytuje należący do wywołującego snapshot drzewa struktury zakorzenionego w jednej stronie

Syntax

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

Description

ReadStructureElements przechodzi oznakowane drzewo struktury dla PageNumber (indeksowanego od jedynki) i zwraca należącą do wywołującego tablicę TPdfStructureElements z typami, tytułami, MCID, indeksami potomków i faktami referencyjnymi

Status wyjaśnia pusty wynik, odróżniając dokument bez oznakowania od odczytu ograniczonego budżetem lub nieudanego

Remarks

Najpierw użyj IsTagged, aby sprawdzić, czy dokument w ogóle niesie drzewo struktury
Powtarzane odczyty są obsługiwane z pamięci podręcznej struktury; zobacz StructureCacheCapacity i StructureElementsForPage
Dla bardzo głębokich drzew preferuj VisitStructureElements, który strumieniuje wizyty zamiast materializować całą tablicę

Example

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