property FormHandle: FPDF_FORMHANDLE; // read only
FormHandle stelt de ruwe PDFium FPDF_FORMHANDLE beschikbaar, aangemaakt via FPDFDOC_InitFormFillEnvironment voor het momenteel geladen document. Deze handle is de toegang tot de interactieve-formulierlaag van PDFium: het is de parameter die elke FORM_*- en FPDF_FFL*-functie verwacht, en bestuurt de rendering van formuliervelden, muis-/toetsenbordgebeurtenisaflevering, focusregistratie en JavaScript-/XFA-callbacks (PDFium fpdf_formfill.h).
De handle wordt aangemaakt wanneer Active True wordt en wordt vernietigd wanneer Active terugkeert naar False of de component wordt vrijgegeven. Behandel deze als ondoorzichtig en kortlevend — sla de waarde niet op voorbij een enkele laad/ontlaad-cyclus en roep nooit zelf FPDFDOC_ExitFormFillEnvironment ertegen aan; de component beheert zijn levensduur.
FormHandle is een geavanceerde eigenschap, nuttig voor het routeren van formuliergebeurtenissen op laag niveau (aangepaste muis-/toetsenbordaflevering, programmatische veldfocus, gescripte verschijningregeneratie, XFA-verversing) wanneer de eigenschappen op hoog niveau FormField / FormFieldAt niet granulair genoeg zijn. Voor formulierrendering heeft de VCL TPdfView deze handle al in zijn tekenlus verwerkt; handmatig gebruik is alleen nodig wanneer u de meegeleverde viewer omzeilt of een alternatieve gebeurtenispijplijn implementeert.
nil wanneer geen document is geladen. Controleer altijd voordat u
PDFium form-fill-API's aanroept.
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);