PDFium Delphi Component Docs

ObjectHandle Prooiedad

Componente: TPdf  ·  Unidad: PDFium
Puntero bruto de PDFium FPDF_PAGEOBJECT para el objeto de página especificado, pensado para llamadas directas a la API C nativa de PDFium

Syntax

property ObjectHandle[Index: Integer]: Pointer;// solo lectura

Description

Devuelve el puntero FPDF_PAGEOBJECT opaco que PDFium usa para identificar el objeto de página en la posición Index de la página actual. El mismo manejador que ObjectBounds, ObjectType y las demás propiedades de objeto indexadas resuelven internamente se expone aquí para que los llamadores avanzados puedan invocar funciones FPDFPageObj_*, FPDFPath_*, FPDFText_* o FPDFImageObj_* que aún no están envueltas por el componente

El manejador es propiedad de la página actual y solo permanece válido mientras la página está cargada Llamar a ReloadPage, cambiar PageNumber, eliminar el objeto con RemoveObject o poner Active en False invalida cada ObjectHandle cacheado previamente. Nunca llame a FPDFPageObj_Destroy en un manejador que ya está adjunto a una página — destruirlo dos veces hará que PDFium falle

Use ObjectType primero para despachar sobre el tipo de objeto al que apunta, y luego convierta y llame a la familia de ayudantes PDFium apropiada. El puntero también se puede comparar por identidad entre llamadas dentro de una sola sesión de página, lo que es útil al correlacionar operaciones de edición con sus objetos resultantes

Parameters

IndexÍndice de objeto de página basado en cero, 0 ≤ Index < ObjectCount

Remarks

Example

// Leer el modo de fusión del primer objeto usando la API PDFium sin procesar
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