ObjectHandle - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Belirtilen page object için ham PDFium FPDF_PAGEOBJECT pointer'ı, native PDFium C API'ye doğrudan çağrılar için tasarlanmıştır

Syntax

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

Description

PDFium'un geçerli sayfadaki Index konumundaki sayfa nesnesini tanımlamak için kullandığı opak FPDF_PAGEOBJECT işaretçisini döndürür. ObjectBounds, ObjectType ve diğer indeksli nesne property'lerinin dahili olarak çözümlediği aynı tanıtıcı burada sunulur; böylece ileri düzey çağıranlar, henüz component tarafından sarmalanmamış FPDFPageObj_*, FPDFPath_*, FPDFText_* veya FPDFImageObj_* fonksiyonlarını çağırabilir

Tanıtıcının sahibi geçerli sayfadır ve yalnızca sayfa yüklüyken geçerli kalır. ReloadPage çağırmak, PageNumber'ı değiştirmek, nesneyi RemoveObject ile kaldırmak veya Active'i False'a çekmek, daha önce önbelleğe alınmış her ObjectHandle'ı geçersizleştirir. Sayfaya hâlihazırda bağlı bir tanıtıcıda asla FPDFPageObj_Destroy çağırmayın — onu iki kez yok etmek PDFium'u çökertir

İşaret ettiğiniz nesnenin türüne göre yönlendirme için önce ObjectType'ı kullanın, sonra dönüştürüp uygun PDFium yardımcı ailesini çağırın. İşaretçi, tek bir sayfa oturumu içinde çağrılar arasında kimlik için de karşılaştırılabilir; bu, düzenleme işlemlerini sonuçlarıyla ilişkilendirirken kullanışlıdır

Parameters

Index Sıfır tabanlı sayfa nesnesi indeksi, 0 ≤ Index < ObjectCount

Remarks

İşaretçi türü ABI taşınabilirliği için Pointer olarak bildirilmiştir; yerel çağrılara geçirmeden önce FPDF_PAGEOBJECT'e dönüştürün
Aralık dışı indeksler exception fırlatmak yerine nil döndürür
Nesneyi yerel PDFium çağrılarıyla değiştirdikten sonra, önbellekteki sayfa content stream'inin yeniden üretilmesi için UpdatePage ile devam edin
RemoveObject'ten sonra PDFium yuvayı yeniden kullanırsa iki farklı sayfa nesnesi kısa süreliğine aynı adresi paylaşabilir — tanıtıcıyı yapısal düzenlemeler arasında elinizde tutmayın

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;

ObjectHandle Özellik