property FormHandle: FPDF_FORMHANDLE; // read only
FormHandle espone l'FPDF_FORMHANDLE raw di PDFium creato via
FPDFDOC_InitFormFillEnvironment per il documento attualmente caricato. Questo
handle è la porta d'ingresso al layer dei moduli interattivi di PDFium: è il parametro
che ogni funzione FORM_* e FPDF_FFL* si attende, e governa il rendering dei
campi del modulo, la consegna degli eventi mouse / tastiera, il tracciamento del focus e i callback JavaScript /
XFA (PDFium fpdf_formfill.h)
L'handle viene creato quando Active diventa True e viene
distrutto quando Active torna False o il componente viene
liberato. Trattalo come opaco e di breve durata — non conservare il valore oltre un singolo
ciclo load/unload, e non chiamare mai FPDFDOC_ExitFormFillEnvironment tu stesso;
il componente è proprietario del suo ciclo di vita
FormHandle è una proprietà avanzata utile per instradare eventi di form di basso livello
(consegna personalizzata di mouse / tastiera, focus programmatico dei campi, rigenerazione degli appearance via script,
refresh XFA) quando le proprietà di alto livello FormField /
FormFieldAt non sono abbastanza granulari. Per il rendering dei moduli il
TPdfView VCL collega già questo handle al suo paint loop; l'uso manuale serve
solo quando bypassi il viewer fornito o implementi una pipeline di eventi
alternativa
nil quando nessun documento è caricato. Verifica sempre prima di
invocare le API form-fill di 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);