property FormHandle: FPDF_FORMHANDLE; // read only
FormHandle biedt de ruwe PDFium FPDF_FORMHANDLE bloot die via
FPDFDOC_InitFormFillEnvironment is gemaakt voor het momenteel geladen document. Deze
handle is de toegangspoort tot de interactieve-formulierlaag van PDFium: het is de parameter die
elke FORM_*- en FPDF_FFL*-functie verwacht, en die form field rendering,
mouse- / keyboard-eventlevering, focus-tracking en JavaScript- / XFA-callbacks aanstuurt
(PDFium fpdf_formfill.h)
De handle wordt gemaakt wanneer Active True wordt en wordt vernietigd
wanneer Active weer False wordt of wanneer de component wordt vrijgegeven.
Behandel hem als opaque en kortlevend — sla de waarde niet op buiten één load/unload-cyclus en roep
zelf nooit FPDFDOC_ExitFormFillEnvironment erop aan; de component beheert zijn levensduur
FormHandle is een geavanceerde property die nuttig is voor het routeren van low-level form events
(custom mouse- / keyboard-levering, programmatic field focus, scripted appearance-regeneratie, XFA-refresh)
wanneer de high-level properties FormField / FormFieldAt niet fijnmazig genoeg zijn.
Voor form rendering koppelt de VCL TPdfView deze handle al aan zijn paint loop; handmatig gebruik
is alleen nodig wanneer je de meegeleverde viewer omzeilt of een alternatieve event pipeline implementeert
nil terug wanneer er geen document is geladen. Controleer dit altijd voordat je PDFium form-fill APIs aanroeptFormHandle werken voor statische field rendering en basisinteractie, maar document-level JavaScript actions zijn inert
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);