ObjectType - TPdf - PDFiumPas

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Component: TPdf · Unit: PDFium

Geeft de categorie terug van het page object op de opgegeven index — text, path, image, shading of form XObject. De classificatie komt overeen met de PDF content-stream operator die het object heeft geproduceerd en laat callers de page-object-array met één switch dispatch doorlopen

Syntaxis

property ObjectType[Index: Integer]: TObjectType; // read only

Index Zero-based page-object index, in the range 0 to ObjectCount - 1.

Beschrijving

ObjectType geeft een TObjectType-enumeratiewaarde terug die het type page object op Index beschrijft:

otText — text-showing operator (Tj, TJ, ', ") — een run glyphs die een font en text matrix delen
otPath — vector path: lines, curves, rectangles en fills. Gebruik ObjectBounds om de on-page rectangle op te halen
otImage — raster image. Combineer met ObjectBitmap om pixels op te halen
otShading — gradient- of functie-gebaseerde shading pattern (PDF axial/radial/coon shading)
otForm — form XObject: een herbruikbare sub-stream die zelf text, paths en images kan bevatten

De classificatie is stabiel en goedkoop; hem in een strakke loop over ObjectCount aanroepen is de standaardmanier om page content te triageren voordat je beslist welke zwaardere accessor (ObjectBitmap, ObjectBounds, character properties) je aanroept

Form XObjects worden door deze property niet recursief uitgewerkt — het type rapporteert otForm en callers moeten in de eigen object list van het form afdalen als ze leaf-level content nodig hebben

Opmerkingen

De index space hier is de volledige object list van de pagina; die is breder dan de image-only index die Image en Bitmap gebruiken
De volgorde van page objects komt grofweg overeen met de paint order, dus itereren in oplopende index rendert bottom-up
Geeft otText terug voor indexen buiten het geldige bereik; bescherm dit altijd met ObjectCount
De enumeratiewaarden spiegelen PDFium's FPDF_PAGEOBJ_*-constanten uit de onderliggende native API

Voorbeeld

// Histogram van object types op de huidige pagina
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;

Zie ook

ObjectCount, ObjectBounds, ObjectBitmap, RemoveObject