EnumPathElements

Extração, Manipulação de páginas

Descrição

Enumera todos os objetos de trajeto vetorial de uma página através de todas as camadas de conteúdo. Cada sequência de construção e pintura de trajeto é elevada a um registo TPDFlibPageElement com Kind ekPath, uma caixa delimitadora que inclui os pontos de controlo das curvas, a contagem de segmentos, a flag de fecho e o nome do operador de pintura. Cada elemento recebe ainda uma fotografia do ElementID para consultas de detalhe posteriores

Sintaxe

Delphi

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

Parâmetros

PageNúmero da página, de base 1, a enumerar
ElementsArray alocado pelo chamador de TPDFlibPageElement que recebe os registos; só são guardados tantos registos quanto a capacidade do array
ElemIndexÍndice de entrada e saída; passe 0 na entrada, à saída contém o número de registos guardados em Elements
TotalCountContador de entrada e saída; à saída contém o número total de trajetos encontrados, mesmo quando excede a capacidade de Elements

Observações

As coordenadas são devolvidas no sistema de origem no canto superior esquerdo usado pelos auxiliares de elementos de página. Compare ElemIndex com TotalCount para detetar truncatura, ou chame duas vezes e dimensione o array a partir da primeira passagem

Para uma enumeração de nível superior que cobre também texto, imagens e colocações de sombreadura, consulte EnumPageElements

Exemplo

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