PDFium Delphi Component Docs

FormFieldAt Egenskap

Component: TPdf  ·  Unit: PDFium
Läs eller skriv värdet för formulärfältet som ligger vid den angivna sidkoordinaten.

Syntax

property FormFieldAt[X, Y: Single]: WString; // read / write

Description

FormFieldAt slår upp den AcroForm-widgetannotering som innehåller punkten (X, Y) i sidrummet och exponerar dess värde som en Unicode-sträng. Koordinaterna anges i PDF användarutrymme, med origo i sidans nedre vänstra hörn och enheten punkter (1/72 tum). Att läsa egenskapen returnerar det aktuella fältvärdet (/V) avkodat till WString; att skriva den uppdaterar fältet och genererar om utseendeströmmar så att det nya värdet renderas vid nästa uppritning

Returnerar en tom sträng när Active är False, när dokumentet saknar AcroForm eller när ingen widget täcker koordinaten. Matchningspolicyn speglar FormFieldInfoAt: endast widgetrektanglar (ingen utseendebaserad träfftestning), den översta widgeten vinner vid överlappningar. Skrivningar är utan effekt när koordinaten missar alla widgetar

För kryssrute- och radioknappswidgetar följer värdesemantiken PDF-specifikationen — att tilldela 'Off' rensar fältet, att tilldela värdet som matchar widgetens on-tillståndsnamn i /AP /N (vanligtvis 'Yes' eller exportvärdet) markerar den. För textfält blir allt du tilldelar det nya /V-innehållet. List-/kombinationsrutor accepterar exportvärdet kopplat till en av alternativposterna. Använd FormFieldInfoAt först för att granska FieldType om fälttypen är osäker

Remarks

Example

// Toggle a checkbox located at (120, 300) on the current page.
if Pdf1.FormFieldAt[120.0, 300.0] = 'Off' then
  Pdf1.FormFieldAt[120.0, 300.0] := 'Yes'
else
  Pdf1.FormFieldAt[120.0, 300.0] := 'Off';

See Also

FormFieldInfoAt, HasFormFieldAt, FormField, FormFieldCount