property FormHandle: FPDF_FORMHANDLE; // read only
FormHandle, geçerli yüklü belge için FPDFDOC_InitFormFillEnvironment üzerinden oluşturulan ham PDFium FPDF_FORMHANDLE'ı açığa çıkarır. Bu handle, PDFium'un etkileşimli form katmanına açılan kapıdır: her FORM_* ve FPDF_FFL* fonksiyonunun beklediği parametredir; form field rendering, mouse / keyboard event iletimi, focus takibi ve JavaScript / XFA callback'lerini yönetir (PDFium fpdf_formfill.h)
Handle, Active True olduğunda oluşturulur ve Active False döndüğünde ya da bileşen serbest bırakıldığında yok edilir. Bunu opak ve kısa ömürlü olarak değerlendirin — değeri tek bir yükleme / boşaltma döngüsünden sonra saklamayın ve üzerinde asla FPDFDOC_ExitFormFillEnvironment çağırmayın; yaşam döngüsünün sahibi bileşendir
FormHandle, üst düzey FormField / FormFieldAt özellikleri yeterince ayrıntılı olmadığında düşük düzey form event'lerini yönlendirmek için yararlı gelişmiş bir özelliktir (özel mouse / keyboard iletimi, programatik field focus, scripted appearance regeneration, XFA refresh). Form rendering için VCL TPdfView bu handle'ı zaten paint loop'una bağlar; elle kullanım yalnızca sağlanan viewer'ı atladığınızda veya alternatif bir event pipeline uyguladığınızda gerekir
nil. PDFium form-fill API'lerini çağırmadan önce her zaman denetleyin
var FH: FPDF_FORMHANDLE;
Pdf1.Active := True;
FH := Pdf1.FormHandle;
if Assigned(FH) then
FPDF_FFLDraw(FH, Bmp, Pdf1.Page, 0, 0, 800, 600, 0, FPDF_ANNOT);