FormHandle Eigenschaft

FormHandle legt den rohen PDFium-FPDF_FORMHANDLE offen, der über FPDFDOC_InitFormFillEnvironment für das aktuell geladene Dokument erzeugt wurde. Dieses Handle ist das Tor zu PDFiums Interactive-Form-Schicht: Es ist der Parameter, den jede FORM_*- und FPDF_FFL*-Funktion erwartet, und steuert die Formularfeld-Renderung, die Zustellung von Maus-/Tastatur-Events, das Fokus-Tracking und JavaScript-/ XFA-Callbacks (PDFium fpdf_formfill.h)

Das Handle entsteht, wenn Active True wird, und wird zerstört, wenn Active auf False zurückfällt oder die Komponente freigegeben wird. Behandeln Sie es als opak und kurzlebig — heben Sie den Wert nicht über einen einzelnen Load/Unload-Zyklus hinaus auf und rufen Sie niemals selbst FPDFDOC_ExitFormFillEnvironment darauf; die Lebensdauer gehört der Komponente

FormHandle ist eine Fortgeschrittenen-Eigenschaft, nützlich, um Low-Level-Formular-Events zu routen (eigene Maus-/Tastatur-Zustellung, programmatischer Feldfokus, per Skript getriggerte Appearance-Regeneration, XFA-Refresh), wenn die hochsprachlichen Eigenschaften FormField / FormFieldAt nicht fein genug granulieren. Für das Formular-Rendering verdrahtet der VCL-TPdfView dieses Handle bereits in seine Paint-Schleife; manueller Einsatz ist nur nötig, wenn Sie den mitgelieferten Viewer umgehen oder eine eigene Event- Pipeline implementieren

• Liefert nil, wenn kein Dokument geladen ist. Immer vorher prüfen, bevor PDFium-Form-Fill-APIs aufgerufen werden
• Der PDFium-Form-Fill-Zustand ist nicht threadsafe — verwenden Sie das Handle nur aus dem Thread, der das Dokument geladen hat
• Ist PDFium ohne die v8-JavaScript-Engine gebaut, funktioniert FormHandle weiterhin für statisches Feld-Rendering und Grundinteraktion, aber dokumentweite JavaScript- Aktionen bleiben wirkungslos