PDFium Delphi Component Docs

ObjectCount Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Anzahl der Seitenobjekte (Text, Pfad, Bild, Shading, Form) auf der aktuellen Seite

Syntax

property ObjectCount: Integer; // read only

Description

Liefert die Anzahl der Seitenobjekte (Text, Pfad, Bild, Shading, Form), die zum geöffneten PDF-Dokument gehören. Die Zählung ändert sich, wenn Page einem anderen Seitenindex zugewiesen wird; sie taugt also als obere Grenze einer for-Schleife, die alle ObjectHandle[Index] durchläuft

Der Wert wird direkt aus der zugrunde liegenden PDFium-Engine gelesen (verlangt, dass Active True ist und eine aktuelle Seite geladen ist). Ist das Dokument geschlossen, hat es im abgefragten Umfang keine Seitenobjekte (Text, Pfad, Bild, Shading, Form) oder ist die Eigenschaft für das aktuelle PDF nicht anwendbar, ist das Ergebnis 0

Weil dieser Zähler von PDFium lazily beim ersten Zugriff berechnet wird, kann der erste Aufruf das Parsen des relevanten Objekt-Streams auslösen (etwa das /Annots-Array der Seite oder den /Names-Baum des Dokuments). Weitere Aufrufe sind O(1)

Remarks

Example

var

  I: Integer;

begin

  if not Pdf1.Active then Exit;

  Memo1.Lines.Add(Format('%d page objects (text, path, image, shading, form)', [Pdf1.ObjectCount]));

  for I := 0 to Pdf1.ObjectCount - 1 do

  begin

    // inspect each item

    Memo1.Lines.Add(Format(' [%d]', [I]));

  end;

end;

See Also

ObjectHandle, ObjectBounds, ObjectTransparent