ReadStructureElements Metodo

Componente: TPdf · Unità: PDFium

Legge uno snapshot di proprietà del chiamante dell'albero della struttura radicato in una pagina

Syntax

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

Description

ReadStructureElements percorre l'albero della struttura con tag per PageNumber (a base uno) e restituisce un array TPdfStructureElements di proprietà del chiamante con tipi, titoli, MCID, indici dei figli e informazioni sui riferimenti

Status spiega un risultato vuoto, distinguendo un documento senza tag da una lettura limitata o fallita

Remarks

Usare prima IsTagged per verificare se il documento possiede davvero un albero della struttura
Le letture ripetute sono servite dalla cache della struttura; vedere StructureCacheCapacity e StructureElementsForPage
Per alberi molto profondi preferire VisitStructureElements, che trasmette le visite in streaming invece di materializzare l'intero array

Example

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