property FormHandle: FPDF_FORMHANDLE; // read only
FormHandle mengekspos FPDF_FORMHANDLE PDFium mentah yang dibuat melalui FPDFDOC_InitFormFillEnvironment untuk dokumen yang sedang dimuat. Handle ini adalah gerbang ke lapisan formulir-interaktif PDFium: ini adalah parameter yang diharapkan setiap fungsi FORM_* dan FPDF_FFL*, mengatur rendering field formulir, pengiriman event mouse / keyboard, pelacakan fokus, dan callback JavaScript / XFA (PDFium fpdf_formfill.h)
Handle dibuat ketika Active menjadi True dan dihancurkan ketika Active kembali ke False atau komponen dibebaskan. Perlakukan sebagai opaque dan berumur pendek — jangan menyimpan nilai melampaui satu siklus muat/bongkar, dan jangan pernah memanggil FPDFDOC_ExitFormFillEnvironment padanya sendiri; komponen memiliki masa pakainya
FormHandle adalah properti lanjutan yang berguna untuk merutekan event formulir level rendah (pengiriman mouse / keyboard kustom, fokus field terprogram, regenerasi appearance ter-skrip, penyegaran XFA) ketika properti FormField / FormFieldAt level tinggi tidak cukup granular. Untuk rendering formulir TPdfView VCL sudah menghubungkan handle ini ke loop paint-nya; penggunaan manual hanya diperlukan ketika melewati penampil yang disediakan atau mengimplementasikan pipeline event alternatif
nil ketika tidak ada dokumen yang dimuat. Selalu periksa sebelum memanggil API form-fill PDFium
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);