PDFium Component Docs

FormHandle property

Component: TPdf  ·  Unit: PDFium
Native PDFium formularudfyldnings-miljøhandle knyttet til dokumentet

Syntax

property FormHandle: FPDF_FORMHANDLE; // read only

Description

FormHandle eksponerer det rå PDFium FPDF_FORMHANDLE oprettet via FPDFDOC_InitFormFillEnvironment for det aktuelt indlæste dokument. Dette handle er porten til PDFiums interaktive form-lag: det er parameteren som hver FORM_*- og FPDF_FFL*-funktion forventer, og styrer formularfelt-rendering, mus-/tastatur-hændelses-levering, fokus-sporing og JavaScript-/ XFA-callbacks (PDFium fpdf_formfill.h).

Handle oprettes, når Active bliver True, og destrueres, når Active vender tilbage til False, eller komponenten frigøres. Behandl det som uigennemsigtigt og kortlevet — opbevar ikke værdien ud over en enkelt load/unload-cyklus, og kald aldrig FPDFDOC_ExitFormFillEnvironment på det selv; komponenten ejer dens levetid.

FormHandle er en avanceret egenskab nyttig til rutning af lavniveau-form-hændelser (tilpasset mus-/tastatur-levering, programmatisk feltfokus, scriptet appearance- regenerering, XFA-refresh), når de højtstående FormField- / FormFieldAt-egenskaber ikke er granulære nok. Til form-rendering har VCL-TPdfView allerede koblet dette handle ind i sin paint-løkke; manuel brug er kun nødvendig ved omgåelse af den leverede fremviser eller implementering af en alternativ hændelses-pipeline.

Remarks

Example

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

See Also

Document, Page, FormType, FormFieldCount