ObjectType - TPdf - PDFiumPas

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Komponente: TPdf · Unit: PDFium

Gibt die Kategorie des Seitenobjekts am angegebenen Index zurück — Text, Pfad, Bild, Shading oder Form-XObject Die Klassifizierung entspricht dem PDF-Inhaltsstrom-Operator, der das Objekt erzeugt hat, und erlaubt Aufrufern, das Seitenobjekt-Array mit einem einzigen Switch-Dispatch zu durchlaufen

Syntax

property ObjectType[Index: Integer]: TObjectType; // nur lesbar

Index 0-basierter Seitenobjektindex im Bereich 0 bis ObjectCount - 1

Beschreibung

ObjectType gibt einen TObjectType-Enumerationswert zurück, der die Art des Seitenobjekts bei Index beschreibt

otText — Textanzeige-Operator (Tj, TJ, ', ") — ein Glyphenlauf mit gemeinsamem Font und Textmatrix
otPath — Vektorpfad: Linien, Kurven, Rechtecke und Füllungen Verwenden Sie ObjectBounds, um das Seitenrechteck zu erhalten
otImage — Rasterbild Kombinieren Sie es mit ObjectBitmap, um Pixel abzurufen
otShading — Verlauf oder funktionsbasiertes Shading-Muster (PDF axialer / radialer / coon Shading)
otForm — Form-XObject: ein wiederverwendbarer Unterstrom, der selbst Text, Pfade und Bilder enthalten kann

Die Klassifizierung ist stabil und günstig; sie in einer engen Schleife über ObjectCount aufzurufen, ist der übliche Weg, um Seiteninhalt zu sichten, bevor entschieden wird, welcher teurere Zugriff (ObjectBitmap, ObjectBounds, Zeicheneigenschaften) aufgerufen werden soll

Form-XObjects werden von dieser Eigenschaft nicht rekursiv erweitert — der Typ meldet otForm, und Aufrufer müssen in die eigene Objektliste des Formulars hinabsteigen, wenn sie den Inhalt auf Blattebene benötigen

Hinweise

Der Indexraum hier ist die vollständige Objektliste der Seite; er ist breiter als der bildnurige Index, den Image und Bitmap verwenden
Die Reihenfolge der Seitenobjekte entspricht grob der Zeichenreihenfolge, sodass eine Iteration in aufsteigendem Index von unten nach oben rendert
Für Indizes außerhalb des gültigen Bereichs wird otText zurückgegeben; schützen Sie immer mit ObjectCount
Die Enumerationswerte spiegeln PDFiums FPDF_PAGEOBJ_*-Konstanten aus der zugrunde liegenden nativen API wider

Beispiel

// Histogramm der Objekttypen auf der aktuellen Seite
var
  I: Integer;
  Counts: array[TObjectType] of Integer;
  T: TObjectType;
begin
  FillChar(Counts, SizeOf(Counts), 0);
  for I := 0 to Pdf.ObjectCount - 1 do
    Inc(Counts[Pdf.ObjectType[I]]);
  for T := Low(TObjectType) to High(TObjectType) do
    Memo1.Lines.Add(Format('%s: %d', [GetEnumName(TypeInfo(TObjectType), Ord(T)), Counts[T]]));
end;

Siehe auch

ObjectCount, ObjectBounds, ObjectBitmap, RemoveObject