PDFium Delphi Component Docs

FormHandle Propiedad

Componente: TPdf  ·  Unidad: PDFium
Identificador nativo del entorno de rellenado de formularios de PDFium adjunto al documento

Syntax

property FormHandle: FPDF_FORMHANDLE;// solo lectura

Description

FormHandle expone el FPDF_FORMHANDLE de PDFium sin procesar creado mediante FPDFDOC_InitFormFillEnvironment para el documento cargado actualmente. Este manejador es la puerta de entrada a la capa de formulario interactivo de PDFium: es el parámetro que esperan todas las funciones FORM_* y FPDF_FFL*, y gobierna el renderizado de campos de formulario, la entrega de eventos de ratón / teclado, el seguimiento de foco y las devoluciones de llamada de JavaScript / XFA (fpdf_formfill.h de PDFium)

El manejador se crea cuando Active se convierte en True y se destruye cuando Active vuelve a False o se libera el componente. Trátelo como opaco y de corta vida — no almacene el valor más allá de un único ciclo de carga/descarga y nunca llame usted a FPDFDOC_ExitFormFillEnvironment sobre él; el componente posee su ciclo de vida

FormHandle es una propiedad avanzada útil para enrutar eventos de formulario de bajo nivel (entrega personalizada de ratón / teclado, foco de campo programático, regeneración de apariencia con script, actualización XFA) cuando las propiedades de alto nivel FormField / FormFieldAt no son lo bastante granulares. Para el renderizado de formularios, el TPdfView VCL ya conecta este manejador en su bucle de pintado; el uso manual solo es necesario al eludir el visor proporcionado o al implementar un canal de eventos alternativo

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