PDFium Component Docs

FormHandle Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Natives PDFium-Formularfüllungs-Umgebungs-Handle, das dem Dokument zugeordnet ist

Syntax

property FormHandle: FPDF_FORMHANDLE; // nur lesbar

Beschreibung

FormHandle stellt das rohe PDFium-FPDF_FORMHANDLE bereit, das über FPDFDOC_InitFormFillEnvironment für das aktuell geladene Dokument erzeugt wurde Dieses Handle ist das Tor zu PDFiums interaktiver Formularebene: Es ist der Parameter, den jede FORM_*- und FPDF_FFL*-Funktion erwartet, und steuert das Rendern von Formularfeldern, die Zustellung von Maus- / Tastaturereignissen, Fokusverfolgung sowie JavaScript- / XFA-Rückrufe (PDFium fpdf_formfill.h)

Das Handle wird erzeugt, wenn Active True wird, und zerstört, wenn Active wieder False wird oder die Komponente freigegeben wird Behandeln Sie es als undurchsichtig und kurzlebig — speichern Sie den Wert nicht über einen einzelnen Lade- / Entladezyklus hinaus und rufen Sie FPDFDOC_ExitFormFillEnvironment niemals selbst darauf auf; die Komponente verwaltet seine Lebensdauer

FormHandle ist eine fortgeschrittene Eigenschaft, die zum Weiterleiten von Low-Level- Formularereignissen nützlich ist (benutzerdefinierte Maus- / Tastaturzustellung, programmgesteuerter Feldfokus, skriptgesteuerte Neuerzeugung von Erscheinungen, XFA- Aktualisierung), wenn die hochstufigen Eigenschaften FormField / FormFieldAt nicht fein genug sind Für das Formularrendering bindet TPdfView aus der VCL dieses Handle bereits in seine Zeichen-Schleife ein; die manuelle Verwendung ist nur nötig, wenn Sie den mitgelieferten Viewer umgehen oder eine alternative Ereignispipeline implementieren

Hinweise

Beispiel

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);

Siehe auch

Document, Page, FormType, FormFieldCount