PDFium Component Docs

ObjectHandle Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Unit: PDFium
Ruwe PDFium FPDF_PAGEOBJECT-pointer voor het opgegeven page object, bedoeld voor directe calls in de native PDFium C API

Syntaxis

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

Beschrijving

Geeft de opaque FPDF_PAGEOBJECT-pointer terug die PDFium gebruikt om het page object op positie Index op de huidige pagina te identificeren. Dezelfde handle die ObjectBounds, ObjectType en de andere geïndexeerde objectproperties intern oplossen, wordt hier blootgesteld zodat geavanceerde callers functies als FPDFPageObj_*, FPDFPath_*, FPDFText_*, of FPDFImageObj_* kunnen aanroepen die nog niet door de component zijn omwikkeld

De handle is eigendom van de huidige pagina en blijft alleen geldig zolang de pagina geladen is. Het aanroepen van ReloadPage, het wisselen van PageNumber, het verwijderen van het object met RemoveObject of het zetten 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 — twee keer vernietigen laat PDFium crashen

Gebruik eerst ObjectType om te dispatchen op het soort object waarnaar je kijkt, cast daarna en roep de juiste PDFium-familie van helpers aan. De pointer kan ook op identiteit worden vergeleken tussen aanroepen binnen één paginasessie, wat nuttig is wanneer je bewerkingen wilt correleren met de resulterende objecten

Parameters

IndexZero-based page-object index, 0 ≤ Index < ObjectCount.

Opmerkingen

Voorbeeld

// Lees de blend mode van het eerste object via de ruwe 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;

Zie ook

ObjectCount, ObjectType, ObjectBounds, UpdatePage, RemoveObject