EnumPathElements

Extraktion, Seitenmanipulation

Beschreibung

Zählt jedes Vektorpfadobjekt einer Seite über alle Inhaltsebenen hinweg auf. Jede Sequenz aus Pfadaufbau und Malen wird in einen TPDFlibPageElement-Datensatz mit der Art ekPath, einer Begrenzungsbox einschließlich der Kurvenkontrollpunkte, der Segmentanzahl, dem Geschlossen-Flag und dem Namen des Maloperators überführt. Jedes Element erhält außerdem eine ElementID-Momentaufnahme für spätere Detailabfragen

Syntax

Delphi

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

Parameter

PageEinsbasierte Seitenzahl, die aufgezählt werden soll
ElementsVom Aufrufer bereitgestelltes Array aus TPDFlibPageElement, das die Datensätze aufnimmt; es werden nur so viele Datensätze gespeichert, wie die Arraykapazität hergibt
ElemIndexEin-/Ausgabe-Index; beim Eintritt 0 übergeben, beim Austritt hält er die Anzahl der in Elements gespeicherten Datensätze
TotalCountEin-/Ausgabe-Zähler; beim Austritt hält er die Gesamtzahl der gefundenen Pfade, auch wenn sie die Kapazität von Elements übersteigt

Hinweise

Koordinaten werden im oben-links-Koordinatensystem der Seitenelement-Hilfsfunktionen zurückgegeben. Vergleichen Sie ElemIndex mit TotalCount, um eine Abschneidung zu erkennen, oder rufen Sie die Funktion zweimal auf und bemessen Sie das Array nach dem ersten Durchlauf

Für eine übergeordnete Aufzählung, die auch Text, Bilder und Schattierungsplatzierungen abdeckt, siehe EnumPageElements

Beispiel

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