PDFium Component Docs

FormFieldAt Eigenschap

Component: TPdf  ·  Unit: PDFium
Lees of schrijf de waarde van het form field op de opgegeven paginacoördinaat

Syntax

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

Description

FormFieldAt zoekt de AcroForm-widgetannotatie die het punt (X, Y) in paginacoördinaten bevat en stelt de waarde ervan bloot als Unicode-string. De coördinaten zijn in de PDF-gebruikersruimte, met de oorsprong linksonder op de pagina en punten (1/72 inch) als eenheid. Lezen geeft de huidige veldwaarde (/V) terug, gedecodeerd naar WString; schrijven werkt het veld bij en genereert de appearance streams opnieuw zodat de nieuwe waarde bij de eerstvolgende weergave zichtbaar is

Geeft een lege string terug wanneer Active op False staat, wanneer het document geen AcroForm heeft of wanneer geen widget de coördinaat bedekt. Het zoekbeleid is gelijk aan dat van FormFieldInfoAt: alleen widgetrechthoeken (geen hit-testing op appearance), bij overlap wint de bovenste widget. Schrijfacties zijn no-ops als de coördinaat naast elke widget ligt

Voor checkbox- en radiobutton-widgets volgt de waardesemantiek de PDF-specificatie — 'Off' toewijzen maakt het veld leeg, de waarde toewijzen die hoort bij de on-staatnaam in /AP /N van de widget (meestal 'Yes' of de exportwaarde) vinkt het aan. Bij tekstvelden wordt alles wat u toewijst de nieuwe inhoud van /V. List- en comboboxen accepteren de exportwaarde die bij een van de opties hoort. Gebruik eerst FormFieldInfoAt om de FieldType te bekijken als het veldtype onzeker is

Remarks

Example

// Schakel een checkbox op (120, 300) op de huidige pagina om
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