EnumPathElements

Estrazione, manipolazione delle pagine

Descrizione

Enumera ogni oggetto tracciato vettoriale di una pagina attraverso tutti i livelli di contenuto. Ciascuna sequenza di costruzione e pittura del tracciato viene sollevata in un record TPDFlibPageElement con Kind ekPath, un rettangolo di delimitazione che include i punti di controllo delle curve, il conteggio dei segmenti, il flag di chiusura e il nome dell'operatore di pittura. Ogni elemento riceve inoltre un'istantanea ElementID per interrogazioni di dettaglio successive

Sintassi

Delphi

Procedure TPDFlib.EnumPathElements(Page: Integer;
  Var Elements: Array Of TPDFlibPageElement;
  Var ElemIndex, TotalCount: Integer);

Parametri

PageNumero di pagina a base uno da enumerare
ElementsArray allocato dal chiamante di TPDFlibPageElement che riceve i record; vengono memorizzati solo tanti record quanta è la capacità dell'array
ElemIndexIndice in uscita e in entrata; passare 0 all'ingresso, all'uscita contiene il numero di record memorizzati in Elements
TotalCountContatore in uscita e in entrata; all'uscita contiene il numero totale di tracciati trovati, anche quando supera la capacità di Elements

Osservazioni

Le coordinate vengono restituite nel sistema di origine in alto a sinistra usato dagli helper degli elementi di pagina. Confrontare ElemIndex con TotalCount per rilevare il troncamento, oppure chiamare due volte e dimensionare l'array dal primo passaggio

Per un'enumerazione di livello più alto che copra anche testo, immagini e piazzamenti di shading vedere EnumPageElements

Esempio

Total:= 0;
SetLength(Elements, 0);
PDF.EnumPathElements(1, Elements, Count, Total);
SetLength(Elements, Total);
Count:= 0; Total:= 0;
PDF.EnumPathElements(1, Elements, Count, Total);