PDFium Delphi Component Docs

FormHandle-egenskap

Component: TPdf  ·  Unit: PDFium
Inbyggt PDFium-handtag för form-fill-miljön som är kopplat till dokumentet

Syntax

property FormHandle: FPDF_FORMHANDLE; // read only

Description

FormHandle exponerar det råa PDFium-FPDF_FORMHANDLE som skapats via FPDFDOC_InitFormFillEnvironment för det aktuella inlästa dokumentet. Detta handtag är ingången till PDFiums interaktiva formulärlager: det är parametern som varje FORM_*- och FPDF_FFL*-funktion förväntar sig och styr rendering av formulärfält, leverans av mus-/tangentbordshändelser, fokusspårning samt JavaScript-/ XFA-återanrop (PDFium fpdf_formfill.h)

Handtaget skapas när Active blir True och förstörs när Active återgår till False eller när komponenten frigörs. Behandla det som opakt och kortlivat — lagra inte värdet bortom en enda inläsnings-/urläsningscykel och anropa aldrig FPDFDOC_ExitFormFillEnvironment på det själv; komponenten äger dess livstid

FormHandle är en avancerad egenskap som är användbar för att dirigera formulärhändelser på låg nivå (egen mus-/tangentbordsleverans, programmatiskt fältfokus, skriptad regeneration av utseenden, XFA-uppdatering) när egenskaperna på hög nivå FormField / FormFieldAt inte är tillräckligt granulära. För formulärrendering kopplar VCL-komponenten TPdfView redan in detta handtag i sin uppritningsslinga; manuell användning är endast nödvändig när du kringgår den medföljande visaren eller implementerar en alternativ händelsepipeline

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