property FormHandle: FPDF_FORMHANDLE; // read only
FormHandle ujawnia surowy FPDF_FORMHANDLE PDFium utworzony przez FPDFDOC_InitFormFillEnvironment dla aktualnie wczytanego dokumentu. Ten uchwyt jest bramą do warstwy interaktywnych formularzy PDFium: to parametr oczekiwany przez każdą funkcję FORM_* i FPDF_FFL*, sterujący renderowaniem pól formularza, dostarczaniem zdarzeń myszy / klawiatury, śledzeniem fokusu oraz wywołaniami zwrotnymi JavaScript / XFA (PDFium fpdf_formfill.h)
Uchwyt powstaje, gdy Active staje się True, i jest niszczony, gdy Active wraca do False albo komponent zostaje zwolniony. Traktuj go jako nieprzezroczysty i krótkotrwały — nie przechowuj wartości poza jednym cyklem wczytania / zwolnienia i nigdy nie wywołuj na nim samodzielnie FPDFDOC_ExitFormFillEnvironment; to komponent zarządza jego żywotnością
FormHandle to zaawansowana właściwość przydatna do kierowania niskopoziomowych zdarzeń formularza (własna obsługa myszy / klawiatury, programowe ustawianie fokusu pola, regeneracja wyglądu przez skrypt, odświeżanie XFA), gdy wyżej poziomowe właściwości FormField / FormFieldAt nie są wystarczająco szczegółowe. W renderowaniu formularza VCL TPdfView już wpięty jest ten uchwyt w pętlę rysowania; ręczne użycie jest potrzebne tylko wtedy, gdy pomijasz dostarczoną przeglądarkę albo implementujesz alternatywny potok zdarzeń
nil, gdy nie jest wczytany żaden dokument. Zawsze sprawdzaj przed wywołaniem API form-fill PDFiumFormHandle nadal działa dla statycznego renderowania pól i podstawowej interakcji, ale akcje JavaScript na poziomie dokumentu są nieaktywne
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);