PDFium Delphi Component Docs

ObjectHandle Propriété

Composant: TPdf  ·  Unit: PDFium
Raw PDFium FPDF_PAGEOBJECT pointeur pour l’objet de page spécifié, destiné aux appels directs vers l’API C native de PDFium

Syntax

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

Description

Renvoie le pointeur opaque FPDF_PAGEOBJECT que PDFium utilise pour identifier l’objet de page à la position Index sur la page courante. Le même handle que ObjectBounds, ObjectType et les autres propriétés d’objet indexées résolues en interne sont exposées ici afin que les appelants avancés puissent invoquer les fonctions FPDFPageObj_*, FPDFPath_*, FPDFText_*, ou FPDFImageObj_* qui ne sont pas encore encapsulées par le composant

Le handle appartient à la page courante et reste valide uniquement tant que la page est chargée. Appeler ReloadPage, changer PageNumber, supprimer l'objet avec RemoveObject ou définir Active sur False invalide tous les ObjectHandle précédemment mis en cache. N'appelez jamais FPDFPageObj_Destroy sur un handle déjà attaché à une page — le détruire deux fois fera planter PDFium

Utilisez d'abord ObjectType pour dispatcher selon le type d'objet pointé, puis convertissez et appelez la famille PDFium appropriée d’aides. Le pointeur peut aussi être comparé pour l’identité à travers les appels au sein d’une même session de page, ce qui est utile pour corréler les opérations d’édition avec les objets qu’elles produisent

Parameters

IndexIndex d’objet de page de base 0, 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