FormFieldAt egenskab

FormFieldAt slår den AcroForm-widget-annotation op, der indeholder punktet (X, Y) i siderum, og eksponerer dens værdi som en Unicode-streng. Koordinater er i PDF-brugerrum, med origo i sidens nederste venstre hjørne og enheder i punkter (1/72 tomme). At læse egenskaben returnerer den aktuelle feltværdi (/V) afkodet til WString; at skrive den opdaterer feltet og regenererer appearance-strømme, så den nye værdi renderer ved næste maling.

Returnerer en tom streng, når Active er False, når dokumentet ikke har nogen AcroForm, eller når ingen widget dækker koordinatet. Matchpolitikken spejler FormFieldInfoAt: kun widget-rektangler (ingen appearance-bundet hit-testing), øverste widget vinder ved overlap. Skrivninger er no-ops, når koordinatet misser hver widget.

For checkbox- og radioknap-widgets følger værdisemantikken PDF-specifikationen — at tildele 'Off' rydder feltet, at tildele den værdi, der matcher widgetens /AP /N-på-tilstand-navn (almindeligvis 'Yes' eller eksportværdien), afkrydser den. For tekstfelter bliver alt, du tildeler, det nye /V-indhold. Liste-/combo-bokse accepterer den eksportværdi, der er knyttet til en af option-indgangene. Brug FormFieldInfoAt først til at inspicere FieldType, hvis felttypen er usikker.

• Skrivninger anvendes straks, men vedvares først til disk ved det næste SaveToFile / SaveToStream-kald.
• For at rydde et tekstfelt skal du sætte værdien til en tom streng; feltet forbliver synligt, men renderer uden glyffer.
• Samtidige skrivninger gennem flere FormFieldAt / FormField-tildelinger er sikre i sekvens, men kald dem aldrig fra baggrundstråde — PDFium-formularfelter er ikke trådsikre.