PDFium Component Docs

ObjectHandle property

Component: TPdf  ·  Unit: PDFium
Surovi kazalec PDFium FPDF_PAGEOBJECT za navedeni objekt strani, namenjen neposrednim klicem v izvorni C API PDFium

Syntax

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

Description

Vrne neprozoren kazalec FPDF_PAGEOBJECT, ki ga PDFium uporablja za identifikacijo objekta strani na položaju Index na trenutni strani. Enak ročaj, ki ga ObjectBounds, ObjectType in druge indeksirane lastnosti objekta notranje razrešijo, je tu izpostavljen, tako da lahko napredni klicatelji kličejo funkcije FPDFPageObj_*, FPDFPath_*, FPDFText_* ali FPDFImageObj_*, ki jih komponenta še ni ovila.

Ročaj je v lasti trenutne strani in ostaja veljaven le, dokler je stran naložena. Klic ReloadPage, preklop PageNumber, odstranitev objekta z RemoveObject ali nastavitev Active na False razveljavi vsak prej predpomnjen ObjectHandle. Nikoli ne kličite FPDFPageObj_Destroy na ročaju, ki je že pritrjen na stran — dvojno uničenje bo zrušalo PDFium.

Najprej uporabite ObjectType za razvrščanje po vrsti objekta, na katerega kazujete, nato pretvorite in pokličite ustrezno družino pomočnikov PDFium. Kazalec je mogoče primerjati tudi za istovetnost med klici znotraj ene seje strani, kar je uporabno pri korelaciji operacij urejanja z njihovimi rezultirajočimi objekti.

Parameters

IndexNičelno osnovan indeks objekta strani, 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