FormFieldAt Eigenschaft

FormFieldAt sucht die AcroForm-Widget-Annotation, die den Punkt (X, Y) im Seitenraum enthält, und legt ihren Wert als Unicode-Zeichenkette offen. Koordinaten liegen im PDF-Benutzerraum, mit dem Ursprung in der unteren linken Ecke der Seite und Punkten als Einheit (1/72 inch). Das Lesen der Eigenschaft liefert den aktuellen Feldwert (/V) als WString dekodiert; das Schreiben aktualisiert das Feld und generiert die Appearance Streams neu, damit der neue Wert beim nächsten Paint gerendert wird

Liefert eine leere Zeichenkette, wenn Active False ist, wenn das Dokument kein AcroForm hat oder wenn kein Widget die Koordinate abdeckt. Die Treffer-Regel entspricht FormFieldInfoAt: nur Widget-Rechtecke (kein Hit-Testing gegen Appearance-Daten), bei Überlappungen gewinnt das oberste Widget. Schreibvorgänge sind No-ops, wenn die Koordinate an allen Widgets vorbeigeht

Für Checkbox- und Radiobutton-Widgets folgen die Wert-Semantiken der PDF-Spezifikation — 'Off' zuweisen löscht das Feld, der Wert, der dem On-State-Namen /AP /N des Widgets entspricht (üblicherweise 'Yes' oder der Export-Wert), setzt das Häkchen. Bei Textfeldern wird jede Zuweisung zum neuen /V-Inhalt. List-/Comboboxen akzeptieren den Export-Wert, der zu einem der Optionseinträge gehört. Im Zweifel über den Feldtyp zuerst mit FormFieldInfoAt den FieldType prüfen

• Schreibvorgänge greifen sofort, werden aber erst vom nächsten SaveToFile- / SaveToStream-Aufruf auf die Platte persistiert
• Um ein Textfeld zu leeren, eine leere Zeichenkette zuweisen; das Feld bleibt sichtbar, rendert aber ohne Glyphen
• Nacheinander ausgeführte Schreibzugriffe über mehrere FormFieldAt- / FormField-Zuweisungen sind gefahrlos, rufen Sie sie aber nie aus Background-Threads auf — PDFium-Formularfelder sind nicht threadsafe