PDFium Component Docs

FormFieldAt Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Unit: PDFium
Lees of schrijf de waarde van het form field op de opgegeven paginacoördinaat

Syntaxis

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

Beschrijving

FormFieldAt zoekt de AcroForm widget annotation op die het punt in pagina-eenheden (X, Y) bevat en biedt de waarde als Unicode string aan. Coördinaten staan in PDF user space, met de oorsprong in de linkeronderhoek van de pagina en eenheden in punten (1/72 inch). Het lezen van de property geeft de huidige fieldwaarde (/V) terug, gedecodeerd naar WString; schrijven werkt het field bij en regenereert appearance streams zodat de nieuwe waarde bij de volgende paint wordt weergegeven

Geeft een lege tekenreeks terug wanneer Active False is, wanneer het document geen AcroForm heeft of wanneer geen widget de coördinaat bedekt. Het matchbeleid volgt FormFieldInfoAt: alleen widget rectangles, geen hit-testing op appearance, de bovenste widget wint bij overlap. Writes doen niets wanneer de coördinaat geen enkele widget raakt

Voor checkbox- en radiobutton-widgets volgen de waardesemantiek de PDF spec — het toewijzen van 'Off' wist het field, het toewijzen van de waarde die overeenkomt met de /AP /N on-state-naam van de widget, meestal 'Yes' of de exportwaarde, zet het aan Voor text fields wordt alles wat je toewijst de nieuwe /V-inhoud. List / combo boxes accepteren de exportwaarde die bij een van de optie-entries hoort. Gebruik eerst FormFieldInfoAt om FieldType te inspecteren als het fieldtype onzeker is

Opmerkingen

Voorbeeld

// 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';

Zie ook

FormFieldInfoAt, HasFormFieldAt, FormField, FormFieldCount