PDFium Component Docs

ObjectHandle eigenschap

Component: TPdf  ·  Unit: PDFium
Ruwe PDFium FPDF_PAGEOBJECT-pointer voor het opgegeven pagina-object, bedoeld voor directe aanroepen naar de native PDFium C-API

Syntax

property ObjectHandle[Index: Integer]: Pointer; // read only

Description

Retourneert de ondoorzichtige FPDF_PAGEOBJECT-pointer die PDFium gebruikt om het pagina-object op positie Index op de huidige pagina te identificeren. Dezelfde handle die ObjectBounds, ObjectType en de andere geïndexeerde objecteigenschappen intern oplossen wordt hier beschikbaar gesteld zodat geavanceerde aanroepers FPDFPageObj_*-, FPDFPath_*-, FPDFText_*- of FPDFImageObj_*-functies kunnen aanroepen die nog niet door de component zijn ingepakt.

De handle is eigendom van de huidige pagina en blijft alleen geldig zolang de pagina is geladen. Het aanroepen van ReloadPage, het wisselen van PageNumber, het verwijderen van het object met RemoveObject, of het instellen van Active op False maakt elke eerder gecachte ObjectHandle ongeldig. Roep nooit FPDFPageObj_Destroy aan op een handle die al aan een pagina is gekoppeld — het tweemaal vernietigen zal PDFium laten crashen.

Gebruik eerst ObjectType om te dispatchen op het soort object waarnaar u wijst, en cast en roep vervolgens de juiste PDFium-familie van helpers aan. De pointer kan ook worden vergeleken op identiteit over aanroepen binnen één paginasessie, wat nuttig is bij het correleren van bewerkingsbewerkingen met hun resulterende objecten.

Parameters

IndexOp nul gebaseerde pagina-objectindex, 0 ≤ Index < ObjectCount.

Remarks

Example

// Read the blend mode of the first object using the raw PDFium API.
uses PDFiumLib;
var Obj: FPDF_PAGEOBJECT;
var Blend: array[0..15] of AnsiChar;
begin
  Obj := Pdf1.ObjectHandle[0];
  if Assigned(Obj) then
    FPDFPageObj_GetBlendMode(Obj, @Blend[0], SizeOf(Blend));
  ShowMessage(string(Blend));
end;

See Also

ObjectCount, ObjectType, ObjectBounds, UpdatePage, RemoveObject